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Preface 


About This Manual 


The AppleCD SC Reference provides information for experienced computer users, 
system administrators, and programmers who want to take advantage of the features of 
the AppleCD SC®. To use this manual, you should have some knowledge of a 
programming language, such as BASIC, Pascal, C, or assembly language, and you 
should be familiar with the computer with which you intend to use your AppleCD SC. 


You do not need to use this manual when simply running packaged programs for your 
Apple® computer. However, this manual can help you if you are running a program 
that can be configured to take advantage of the features of the AppleCD SC, or if you 
are writing or modifying a program that uses the AppleCD SC. 


Instructions for connecting the AppleCD SC to your computer, inserting CD-ROM 
cartridges, and other routine operating tasks are provided in the AppleCD SC Owner's 
Guide that came with your AppleCD SC. 


This preface describes the contents of this manual, and the visual cues and 
conventions used throughout the book. It also lists some other books that you may 
wish to refer to when using this manual. 


vil 


What this manual contains 


AppleCD SC Reference describes the operating modes and special capabilities of the 
AppleCD SC as well as the hardware and software interface to the host computer. 


The following is a brief outline of the contents of this manual. 


O Chapter 1, “Introduction to CD-ROM,” includes a description of the fearures and 
possible uses for AppleCD SC. This chapter steps through the data preparation 
process for creating information to be placed on CD-ROMs. 


Chapter 2, “AppleCD SC Software,” provides a functional description of how the 
Macintosh and Apple II software works at the operating system level to allow the user 
to read data from the AppleCD SC. 

Chapter 3, “High Sierra and AppleCD SC,” includes an overview of the High Sierra 
file system, and describes how it differs from the native HFS and ProDOS interfaces 
on the Macintosh and Apple I. 


Chapter 4, “HyperCard and CD-ROM,” describes considerations for choosing a 
retreival model. It explains the advantages of using HyperCard as the data retrieval 
engine or as an interface layer between the retrieval engine and large databases. 
This chapter provides examples of HyperCard retrieval interfaces, and describes 
how one can utilize HyperCard XCMDs to bring existing database libraries into the 
Macintosh environment 

Chapter 5, “Networks and AppleCD SC,” provides implementation-specific 
information.for using AppleCD SC as a server on a network. 

Chapter 6, “AppleCD SC Functional Overview,” provides a general overview of the 
hardware and firmware components of the AppleCD SC drive and includes a 
functional block diagram of the AppleCD SC drive. 

Chapter 7, “AppleCD SC CD-Audio and Sound Production,” provides a 
description of how to implement the stereo-CD capibility on AppleCD SC. The CD 
Remote DA for Apple Ile is used as an example. 

Chapter 8, “AppleCD SC SCSI Commands,” includes the AppleCD SC device- 
specific SCSI command descriptions. 

Appendix A, “AppleCD SC Specifications,” lists the specifications for the AppleCD 
SC. 

The table of contents provides a complete list of the subjects covered in each chapter. 
This book also contains a glossary of technical terms used in the manual, and an 
index. 
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How fo use this manual 
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This manual provides information for programmers and developers with a variety of 
needs and levels of experience. The following guidelines can help you get the most out 
of this book. 


© If you are not writing programs but are interested in learning more about CD-ROMs 
in general, and about the AppleCD SC in particular, read Chapters 1, and 6. Look 
through the rest of the book to get an idea of the kinds of tasks the AppleCD SC can 
do. You might also want to read Chapters 2, 4, 7 and 8 to learn about all the 
considerations involved in writing programs for your AppleCD SC. 


If you are using this book to learn how to configure or customize a program to take 
advantage of the AppleCD SC’s features, read Chapters 2, 3, 4 and 8. 


If you have experience writing programs that use CD-ROMs, but are unfamiliar with 
the AppleCD SC, look through Chapters 1 through 5 to learn about the features and 
options available. Then go back to the detailed description of a command in 
Chapter 8 when you are ready to use it. 


0 


0 


Visual cues and conventions 
Look for these visual cues throughout the manual: 
* Note: Notes like this contain supplementary information. 


Warning Wamings like this direct your attention to something that could 
damage either software or hardware or result In loss of data. 


Terms in boldface type are defined in the Glossary. 

A special typeface is used for characters that you type or for lines of program code: 

It looks like this. 

In general, commands are sent to the AppleCD SC with no spaces between characters 
in the command. Spaces between characters in sample commands in this manual are 


for legibility only. When the space character is included as part of a command, it is 
shown as SPACE. é 


Hexadecimal numbers are Seer by a dollar sign ($), except in tables where 
hexadecimal numbers are clearly labeled. For example, the hexadecimal equivalent 
of decimal 16 is writen as $10. 


Where to look for more information 


Where to look for more information 


AppleCD SC Reference assumes that you are familiar with CD-ROM technology and 
many of the possible uses for CD-ROM. However, additional information and ideas 
are presented in these documents: 

O The AppleCD SC Owner's Guide, which is shipped with every AppleCD SC, explains 
how to set up a AppleCD SC in the standard configuration. The manual gives basic 
operating information, such as how to insert, eject, and store discs. 

2 Inside Macintosh published by Addison-Wesley. 


O The Complete HyperCard Handbook by Danny Goodman, published by Bantum 
Computer Books. 
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Chapter 1 


Introduction 
to CD-ROM 


The AppleCD SC Reference is primarily for the professional developer or information 
provider interested in working on CD-ROM products for use with the Macintosh or 
ApplelIl computers. The AppleCD SC Reference also serves to provide basic 
information for anyone interested in knowing about CD-ROM. To satisfy these diverse 
audiences, this introduction contains basic information about CD-ROM, the 
AppleCD SC, and things you need to know before you decide to develop software or 
put information on CD-ROM to be used with the Macintosh and Applell. 


If you already understand CD-ROM and the steps involved in the CD-ROM creation 
process, but are interested in learning about the AppleCD SC device software, you 
may want to skip ahead and start your reading at Chapter 2. 


What is CD-ROM? 


CD-ROM Compact Disc-Read Only Memory is a non-magnetic storage and retrieval 
medium for large amounts of digital data. The principle users of CD-ROM and 
AppleCD SC are personal computer users, using either the Macintosh or Apple. CD- 
ROM is a relatively new technology, which stems directly from the CD-Audio Compact 
Disc-Audio industry. Like CD-Audio, data on CD-ROM is stored on a hard plastic 
disc, measuring 12 centimeters (43/4 inches) in diameter and slightly over one 
millimeter thick (1/20 inch). 


A CD-ROM can store 656 megabytes of text, or up to 748 megabytes of graphics. You 
could compare that to about 200,000 single-spaced typewritten pages, or the contents 
of 935 floppy disks with a capacity of 800 kilobytes each. Data on a CD-ROM is not 
limited strictly to text and graphics. Anything that can be digitized for use on the 
computer can be stored on CD-ROM. Examples of commonly digitized data include: 
computer applications software, sound, music, and graphics. 

The popularity of CD-ROM is not only based on its high capacity for data storage, but 

other admirable qualities, including: 

@ Information on CD-ROM is stored as Read Only Memory, which means it cannot 
be changed or deleted. 

gw CD-ROM provides immediate access to large amounts of information, and allows 
easy, rapid cross-referencing of information. 

a The discs are constructed of high impact polycarbonate and are not susceptible to 
damage by scratches, dust, magnetic fields, or water like floppy disks are. 
Additionally, when a disc is placed in the AppleCD SC caddy, it is basically free 
from any possible dangers of miss-handling in the typical office environment. 

@ CD-ROM mastefing and reproduction costs are quite low on a per megabyte basis, 
and continue to decrease as CD-ROM technology increases. 

@ Unlike Videodisk, and other standards, such as CD-I, it is possibile to simulate a 
CD-ROM’s performance characteristics before actually producing the disc, thereby 
reducing some of the cost of product development 
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Given that the CD-ROM is small, nearly indestructible, and has the capacity for 
storing large amounts of data, it is an ideal way of getting information into the 
personal computer user's hands. The next section describes some of the possible uses 
for CD-ROM and AppleCD SC. 


Ideas for information access 


You might wonder about the possible uses for CD-ROM. What appears to be just 
another incredibly large disc, particularly one that you can’t write to, may not seem 
very useful at first glance. To help dispel any negative thoughts about the usefulness of 
CD-ROM, you should be aware that there are plenty of interesting and valuable 
applications currently available and many other exciting possibilities being worked 
on. 


CD-ROM is an excellent vehicle for widely dispersing extremely large databases of 
information. Some examples of the areas in which CD-ROM would be most useful are: 


Art and publications 
© Graphic image data bases 
O Dictionaries,thesauruses, and style guides 
Q Design element, glossary, and document boiler plate databases 
Education 
© Interactive tutorials 
QO Multi-lingual audiovisual dictionaries and encyclopedias 
Industry 
© Manufacturer parts lists, which break down unit assemblies into components 
lists. 
© Component and product specifications 
O Engineering and mechanical drawings 
© On-line technical documentation 
Government & legal 
© US federal trademark information with graphics 
OQ Agency regulations 
Q Court decisions 
© Census data 
© Maps at national, state, regional, and metropolitan level 
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Finance 
O Financial statements 
© US federal tax forms 
O Market research and analysis reports 
O Stock market history 
Science and medicine 
O Cancer research data 
Q Medical dictionary 
OQ Scientific writings 
OQ Toxicology database 
Reference 
Oo Encyclopedias 
O Library catalogs 
© Periodicals and newspapers 
As you can see, there are plenty of areas to explore, and this list only touches on the 


possibilities. Later in Chapter 4, an example of a possible Macintosh interface fora 
CD-ROM educational reference is presented. 


Why put information on CD-ROM? 


Let’s consider the advantages of the CD-ROM over conventional reference media, 
such as books, on-line services, or floppy disk, any one of which might supply the 
same type of information listed above. 


One of the advantages of CD-ROM is that it doesn’t take up as much space as the other 


reference media. For example, an entire collection of encyclopedias on your desktop 


would be hard to handle and cumbersome to search through. On the other hand, a 


AppleCD SC with an entire encyclopedia on CD-ROM could fit under your computer, 


or be placed away from your work area, and with the right application software the 


AppleCD SC would supply information. with just the click of the mouse. Also, given the 


strength of the Macintosh’s cut and paste functionality, this diverse amount of 
information can be easily integrated into a user’s productive environment. The user 
would no longer need to struggle with a large stack of encyclopedias. 
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In an office where many people might use on-line services to access information, CD- 
ROM can be an inexpensive and more efficient alternative. On-line services run on 
the phone lines, and phone lines generally don’t provide the data transfer rates of a 
AppleCD SC connected directly to your computer. Slow transfer rates over the phone 
lines means that searching for information and moving it into the computer memory 
for use will be comparatively slow, frustrating process for the user. Additionally, 
connect time can be very expensive. Having the ability to quickly search and transfer 
data from the CD-ROM connected to the computer is going to make the user happier 
and save on the operating overhead created by excessive use of the phone lines. 


The advantages of CD-ROM over floppy disks are fairly obvious from most of the 
information presented earlier. CD-ROM holds far more information, it’s not easily 
destroyed, and can’t be inadvertently erased. 


For more information about the technology and construction of CD-ROM and how 
the AppleCD SC reads the data on the disc, see “AppleCD SC Functional Overview,’ 
Chapter 6. The next section provides an overview of the AppleCD SC features. 


AppleCbD SC features 


The AppleCD SC, shown on Figure 1-x1, provides a CD-ROM solution for both the 
Macintosh and AppleII computers. AppleCD SC has the following features: 


m AppleCD SC has the same footprint as the SC20 hard disk, the SC40 tape backup, 
and other Apple high capacity storage devices. The AppleCD SC’s standard 
footprint and compact design allow it to fit under the Macintosh Plus, and 
Macintosh SE. AppleCD SC can also be easily stacked with additional Apple 
peripheral devices. 


w AppleCD SC is a SCSI Small Computer System Interface device, which is easily 
connected to the Macintosh Plus, SE, and I, as well as the Apple Ie and IIGs 
configured with an Apple II SCSI card (A2B2087 rev. C ROM or later). AppleCD 
SC can be daisy-chained within a group of up to seven SCSI devices, which may 
include additional AppleCD SCs. 

w AppleCD SC reads CD-ROM and plays audio CDs audio compact discs. In 
addition to the variety of CD-ROM applications available for your use on both the 
Macintosh and Applell, you can also listen to any of your favorite stereo CDs by 
using the CD Remote desk accessory and a set of extemally powered speakers or 
stereo headphones. The CD Remote desk accessories are supplied with the 
AppleCD SC. 


@ AppleCD SC has a pair of stereo RCA jacks for connection to amplified speakers, a 
headphone jack, and a volume control. 


® AppleCD SC has a built-in 64K data buffer to maintain maximum data transfers to 
the host computer. 


What Is CD-ROM? 


# AppleCD SC supports the Phillips/Sony CD-ROM Yellow Book industry standard 
for modes Cl and C2 and the CD-Audio Red Book standard. 


(For more information about the technical features and specifications of the AppleCD 
SC drive, see Chapter 6, “AppleCD SC Technical Overview” and Appendix A. 
“Specifications” 


Figure 1-1 
AppleCD SC 
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Creating a CD-ROM—What’s involved? 


Although few conventions currently exist for CD-ROM product creation, this section 
attempts to generically categorize and explain the process. The step-by-step process 
to create a CD-ROM is presented in Figure 1-2, and described in the text following the 
block. diagram. 


Product itl the 
design ues 
system 
Data 
collection 
Data Data 
preparation conversion 
Data 
indexing 
Logical 
formatting 
Disc , 
; Maste 
Finished product 
Figure 1-2 


The steps to create a CD-ROM 


Creating a CD-ROM—What's Involved? 
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Product design 


Your product design is the key point from which you base all of your future decisions. It 
also serves to ensure that your first time results are in fact your intended results without 
doing the process again. A good product design focuses on a particular audience. To 
decide on what audience your product will be aimed at, you must first thoroughly 
analyze the audience’s potential market share and what other competitive products 
already exist for that audience. From this analysis you can decide what information, 
features, and functions will be required to make your product successful with your 
chosen market audience. 


The product design also includes considerations for disc contents, product price, 
packaging, distribution channels, and the estimation of time and effort required to 
meet your target goals. To help you with your decisions about the product design, 
consider these questions: 


1. How is the data currently presented? Is the data in the form of books, disks, 

monthly periodicals, and so on? 

What audience or audiences see the data as valuable? 

Does the audience use the data as it is currently presented? 

How can the presentation be improved on CD-ROM? 

How can the data be economically converted into machine readable form for 

use on CD-ROM? 

O Does it need to be converted from tape? Tape includes both video and audio. 

© Does the data have to be keyed on a word processing system, or can the data be 

captured by other techniques, such as an optical character reader (OCR), or in 
the case of graphics, image scanning? 

OQ Does the data require a lot of formatting for screen presentation and editorial 

cleanup. 

6. How often will the data need to be updated and how will updates be handled? Will 
the product be a service with monthly or quarterly updates, or will you notify the 
customer of an update, giving them the option to purchase the new material? 

7. Will you have to license the information from an information provider? 

8. What kind of retrieval software will best serve your customer? Will you create a 
customized retrieval engine or license a general purpose one. 

9. Will the retrieval and application software be on the CD-ROM or on floppy 
diskette? It is generally best to have the software distributed on floppy disk, 
because you may want to have the flexibility to upgrade without mastering 
another series of CD-ROMs. 

10. Will you license the product or sell it outright to the customer? 


11. How will the product be packaged? Will you need special graphics for your disc 
label and package presentation? 


WM mR WwW bh 
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12. How will you deliver the product? Through computer dealerships, software 
outlets, direct sales, or will you use it exclusively within your own company? 


Another key element for a successful product designed to work in the Apple computer 
market is the user interface. This really can’t be over emphasized, Apple computer 
users expect an interface that: 


O extends the Apple desktop metaphor (described in the “Human Interface 
Guidelines, The Apple Desktop Interface,” which is available from Adison 
Wesley) 


O is rich in graphic elements 


© provides ease of integration into the user’s work environment by being consistent 
and following the Human Interface Guidelines 


© is intuitive and requires very little tutorial documentation, so that the 
discretionary and professional user feel equally at home 


Q incorporates compatibility for future updates 


Defining the delivery system 


During this stage of the CD-ROM creation process you analyze how your CD-ROM 
data is going to be delivered to the user. Here the term delivery refers to hardware and 
software delivery, rather than distribution and sales delivery. The target delivery 
system for CD-ROM products for the AppleCD SC is the Macintosh and Applell. The 


typical questions you must focus on during the defining of the delivery system stage 
are: 


1. What type of software is going to make the product valuable and exciting to the 
customer? 

2. Who will engineer and maintain the software? 

3. What is the target machine? If you are an information provider you may want your 
data to be accessible by more than one brand of computer. 


4. Does your product require the use of special hardware, such as a large screen color 
monitor or a laser printer? Will your target audience be willing to purchase a 
product that requires special equipmenv? 

5. Will you provide a complete CD-ROM solution, which includes the computer 
hardware delivery system and your CD-ROM? 


If you plan to market a complete CD-ROM solution, which includes system hardware 

and software, here are some additional marketing issues that will require your 

attention: 

1. How will you deliver the hardware? Will you sell it outright, lease it, or package it 
with a product subscription? 
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2. Where will you procure the system components? Will you purchase the 
components from a system integrator, or buy them directly from a dealership or 
manufacturer? 


3. How will the system be serviced and warrantied? 


Software development 


If you are an information provider, you have several things to consider. Do the 
software development in-house or contract the work from an outside source. Having 
an in-house programmer (or programmers) that understand the target computer and 
operating system is ideal for software product support and fast turnaround when 
developing fresh ideas. If you are a software developer, particularly a developer that 
has not worked with Apple CPUs and software before, you also need to decide whether 
to bring Apple expertise in-house for your project. 


Regardless of whether you bring the software expertise in-house or contract on the 
outside, you still need to analyze how the retrieval software will be handled. Are you 
going to start from scratch and create your own retrieval engine, or license a general 
purpose engine and enhance the functionality for your application? 


Software development for CD-ROM encompasses several areas. You need to decide 
what areas of the software you intend to do yourself and which areas should be 
contracted or licensed from other sources. The amount of work for each area of 
software development will depend largely on the specifications of your product 
design. The list that follows provides a good preliminary outline of the areas of 
software development where you need to concentrate your efforts. 


g The development of the user interface for either or both the Macintosh and ApplelI 
families of computers. (The “Human Interface Guidelines, The Apple Desktop 
Interface” which is available from the Addison Wesley, provides an excellent 
reference for implementation of the Apple desktop interface metaphor.) An 
example of a desktop interface that follows the ideas presented in the Human 
Interface Guidelines reference is provided in Chapter 4. 


w The programming of the retrieval software (sometimes referred to as the retrieval 
engine) for a new Apple product, porting an existing retrieval engine so that it works 
on either the Macintosh or Appilell, or licensing existing retrieval software that has 
been created for the Macintosh or Applell. The retrieval engine is the software that 
actually does the search requested by the user interface. A description of CD-ROM 
retrieval engines is provided in Chapter 4. 

@ Programming device resources (commonly referred to as device drivers) for 
application output. If your CD-ROM product design calls for the application to 
output to devices not currendy supported by Apple device resources, you need to 
provide device-specific resources for your application. For example, output 
devices might include: typesetting equipment, printers, plotters, and so on. 
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B Building the index for your CD-ROM retrieval software. The index is a key element 
for locating words on the CD-ROM during the search process executed by the 
retrieval software. 


® Localizing your interface for foreign countries. This would include development or 
purchase of special character sets, and translating the language in your data base 
and interface. Information for localizing Macintosh applications canbe found in 
both “Inside Macintosh” and the “Human Interface Guidelines, The Apple Desktop 
Interface.” 


The interface, the retrieval engine, the data, and the index are going to be the pieces 
of your software development effort that together make up your application. To 
produce an efficient CD-ROM application, these phases of software development 
must be carefully thought out and closely tied to each other. 


Data preparation 


The data preparation phase includes several steps, which are made up of some areas 
requiring considerable expertise. As you saw in Figure 1-2, the data preparation step in 
the CD-ROM creation process is generally made up of three areas: 

gw Data collection 

@ Data conversion 


w@ Data indexing 


Data collection 


This step is often referred to as the data capture step, because it includes both the 
creation and the transformation of original data from diverse sources and conversion 
of that data into one format. For example, the data could be binary, line drawings, 
photographs, video film, word-processing files, or it may not yet exist in a machine 
readable form. 


To get the data into a useable form, you first create and convert all dissimilar types of 
data into a format that can be read by 2 computer. This may involve digitization of 
analog sound, graphics, text, video tape, and so on. 


The data capture step is one of the areas that may require expertise from outside 
vendors. Getting data, which may exists only in books into machine readable form 
requires many hours of keying the data into a computer. If you are not set up to do alot 
of keying, this task is better left to vendors that specialize in word processing. If 
resources and the proper equipment is available, conversion of photocomposition 
tapes, digitization of analog sound, OCR of text data, and scanning of graphic images 
can be done in-house. 
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Data conversion 


After the data has been converted into a machine readable form, it may still not be in 
a form that the retrieval and indexing software will be able to use. It is during the data 
conversion stage that you reformat and code the data to be read, displayed, and 
indexed. For example words, paragraphs, pages, chapters and section markers may 
have to be encoded so they can be indexed for your retrieval software. Additionally, 
you need to perform as much error correction on the textual data as possible. Typical 
errors you want to catch and correct are: all spelling, formatting, style, and outdated 
material errors. Error correction during the data conversion stage is important, 
because the next phase of data preparation, data indexing, will index all overlooked 
errors along with the good data. Catching and correcting the errors later in the 
production cycle will be costly and cause time delays in your project schedule. 


You will also need to monitor the total size of your text, graphics, and sound data. If 
the data exceeds the size of your disc, you may need to consider data compression. 
Also remember that if you do compress the data, it will have to be decompressed later 
when it is displayed on the screen. The data compression stage is done with software 
and in some cases hardware, which may add considerably to your production costs 
and the cost of the product to the user. 


If you plan to produce a product which includes sensitive or programming data that 
you want to protect so that it is not easily copied, you will also want to encrypt the data 
during the data conversion process. Here again, the data encryption process requires 
the use of special encryption and decryption software, which may add to the cost of 
the final product. 


Data indexing 


In the same way that an index for a book allows you to find information quickly, data 
indexing allows the retrieval software to quickly locate information on a CD-ROM. The 
index provides a table of word occurrences for every word and the location of each 
word on the CD-ROM. Due to the quantity of data and slower access times of the 
typical CD-ROM, it is necessary that all data be indexed, otherwise data retrieval 
could take an unacceptable amount of time. The structure of the data index is closely 
tied to the retrieval and application software. Indexing schemes vary according to the 
type of data and presentation being provided to the user. For example, a full-text 
reference product that presents formatted pages of information to the user would 
require a list of every word, chapter head, paragraph, and sentence. Each application 
design may require a slightly different method of indexing to make it efficient and 
useful with the data. 
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Logical formatting 


The logical formatting stage places all of the text, graphics, sound, or other forms of 
data into a unified file structure onto 9-track, % inch magnetic tape. It is from this 
unified structure that your file management software is able to find and retrieve data 
from the disc. Your choices here are to use a format readabie by the target machine or 
pick a format that is accepted universally. For example, the ProDOS file format for the 
Apple II family, or the HFS file format for the Macintosh family. If you elect to use 
either of the Apple formats, of course your disc will become machine dependent. 
Alternatively, you could convert all the data into the High Sierra format, which would 
make the disc readable by most of the computers that support the CD-ROM High 
Sierra format. (The High Sierra format is discussed in Chapter 3, “High Sierra and 
AppleCD SC.”) 


This is also the time to test and optimize your retrieval software, and physically 
arrange the layout of data for the tape. For example, if you plan to have audio playing 
at the same time an animated graphic or text screen is scrolling, you will want to have 
the graphics or text and audio data tracks as close to each other as possible. 


The logically formatted tape should be an ANSI compatible tape or tape set formatted 
to Level 3 of the ANSI “Standard for Magnetic Tape Labels and File Structure for 
Information Interchange” (X3.27-1978). The tape recording density can be either 
6250 or 1600 BPI. The information on the tape should be an exact data image of what 
the CD-ROM manufacturer will transfer to the CD-ROM master. All of the CD-ROM 
mastering facilities can supply more information about the requirements for the tape 
format. 


Disc mastering 


The CD-ROM disc mastering process includes: 
m@ premastering 

@ mastering 

® replication and packaging 


If resources are available, you can use one of the microbased premastering subsystems 
for CD-ROM development. CD-ROM development subsystems allow you to actually 
build the logically formatted tape, and do realtime simulation of the CD-ROM 
environment. Micro-based subsytems also have the capability of preparing the 
premastered tapes in-house. 


If the appropriate software is available, premastering can be performed on any 
number of computer systems that have large disk and tape storage capabilities. The 
mastering and replication stages of the CD-ROM creation process are done by firms 
that specialize in CD-ROM manufacturing. 
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Premastering 


After the logically formatted tape has been made, it is sent to a CD-ROM mastering 
and manufacturing facility. The mastering facility processes the data on the tape, 
adding error detection and correction information. The combination of data and 
error correction information makes up the final CD-ROM format, which will be used 
in the CD-ROM mastering process. If the appropriate software is available, and you 
are using a microbased premastering CD-ROM development subsystem, the tapes 
may already have the error correction information and be ready to be used in the CD- 
ROM mastering stage. 


Mastering 


During the mastering stage a CD-ROM master disc is made. A simplified diagram of 
the CD-ROM mastering process is shown in Figure 1-3. The mastering process starts 
with a glass disc that is coated with a photoresist layer. Using extremely fine tolerance 
equipment, a laser beam is modulated synchronously with the digital information on 
the premastered tape. The modulated laser beam exposes the photoresist layer on the 
surface of the spinning glass disc and records the digital information. Photo 
developing chemicals are applied to the exposed photoresist layer, which cleans the 
glass master leaving only the digital imprint created by the laser beam. Then a nickel 
layer is applied to the disc creating a metal master stamper. To preserve the master 
stamper, several additional metal stampers are made for later use in the CD-ROM 
replication process. 


Figure 1-3 
The steps involved in the CD-ROM mastering process 
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Replication 


During disc replication, the metal stampers are used in a transfer molding process to 
make an exact imprint of the information surface on polycarbonate discs. The 
polycarbonate discs are coated with a thin reflective aluminum layer, as shown in 
Figure 3. The aluminum layer is then coated with a protective plastic, and the CD- 
ROM label is silk screeened on the plastic layer side of the disc. 


Packaging 


This stage puts the CD-ROM product together in the finished form with all of its pieces. 
The packaging pieces generally include: the package the CD-ROM will be contained 
in, the user documentation for the product, warranty and additional services 
documentation, and the shipping container. Many of the CD-ROM mastering 
facilities provide a service that takes all of the pieces of your CD-ROM product, puts 
the pieces together, and ships the finished product to your distribution center or end 
user. 


Equipment and software for CD-ROM product development 


In this section we assume that you are interested in providing information or creating 
retrieval software for Macintosh or AppleIl computer users. This group of computer 
users will also be using your CD-ROM product on the AppleCD SC. Here are some 
things you need to consider before getting started. 


What kind of equipment works best for compiling information and retrieval software 
for Apple computers? 


Do you want to create a CD-ROM made specifically for Apple computers? 


Do you want to use a CD-ROM that has already been pressed in High Sierra format and 
provide a retrieval interface for the Macintosh or Applel?? 


Where can you save money when developing an Apple CD-ROM product? 
The information that follows attempts to answer the questions presented above. 


There is always one question that comes up when computer equipment and software is 
mentioned. What is going to give me the most bang for the buck? We know that not 
everyone has all the money they would like to have when getting started on a new 
venture, so the following list starts with the minimum hardware and software 
configuration for Macintosh and AppleII CD-ROM product development 
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Developing software for a Macintosh 


If you plan to develop CD-ROM products for the Macintosh Plus, SE or I, the 
hardware and software that provides the fastest turnaround for the smallest investment 
is a Macintosh II configured with a minimum of 5 megabytes of memory, a 
monochrome monitor, a keyboard, an Apple HD 80SC, and whichever Macintosh 
target machine you pian to run the software on. If your product is targeted for the 
Macintosh II, and you intend to use color graphics as part of your product, you need to 
add the Macintosh II color graphics card configured with extended memory and a 
Macintosh I color monitor or compatible to your system. 


The ideal development software for the Macintosh is the Macintosh Programmer's 
Workshop (MPW) Shell. The MPW shell is a robust integrated, window-based 
environment for program editing, file manipulation, linking and program execution. 
The system also includes many other tools that create and manipulate text and 
resource files. C, Pascal, and Assembly languages are available for the MPW shell. 
Brief descriptions of the MPW tools, and languages are as follows: 


€ Macintosh Workshop C: A C compiler that runs in the MPW Shell. It provides the 
tools, interfaces, and libraries to develop applications written in C. 

O Macintosh Workshop Pascal: Provides the tools, interfaces, and libraries to 
develop applications written in Pascal. 


© MacApp: An expandable generic application that can greatly simplify and speed 
the process of software development. MacApp consists of a set of object-oriented 
libraries that implement the standard Macintosh user interface in such a way that 
you can write applications as extensions to MacApp. 


Depending on the programming language you'll be using, you may want to order one 
or more of the MPW reference manuals listed below. 

Inside Macintosh Volumes I, I, and IV 

MPW Reference Manual 

MPW Assembler Reference Manual 

MacApp Programmer's Reference Manual 

MPW Pascal Reference Manual 

MPW C Reference Manual 


00000 0 


MPW, the accompanying tools and languages, and documentation are available from 
the Apple Programmer's and Developer's Association (APDA). 


Development time for the user interface portion of your Macintosh CD-ROM product 
can be greatly reduced with the use of HyperCard. To learn more about how 
HyperCard can help you to quickly build Macintosh user interfaces, see Chapter 4, 
“HyperCard and AppleCD SC.” 
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Developing software for the Apple II farnily 


If you plan to develop CD-ROM products for the Apple II, the hardware that provides 
the fastest turnaround for the smallest investment is a Apple IGS configured with 1 
megabyte of memory, a monochrome monitor, a keyboard, an Apple HD 80SC (80 
megabyte hard disk), and the Apple II target machine. The software to use with the 
Apple II is Apple Programmer's Workshop (APW). 


APW, the accompanying tools and languages, and documentation are available from 
the Apple Programmer’s and Developer’s Association (APDA). 
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This chapter describes the interaction between the AppleCD SC device driver and the 
Macintosh operating system managers. It also provides the AppleCD SC system-level 
device control and status calls for the Apple II SmartPort interface and the Macintosh 
device driver. 


What makes the AppleCD SC work? 


The AppleCD SC device driver is the device controller software that provides a 
nonspecific interface to system software. The device driver services requests from the 
computer by receiving commands from the computer's operating system and 
converting those commands into device activity. 


The purpose of the CD-ROM device driver, AppleCD SC, is to provide the software 
connection between Apple Macintosh computers (Mac Plus, Mac SE, and Mac II) and 
the AppleCD SC. This release of the driver also provides limited support to the 
Toshiba XM-2000A and Philips CM 110 CD-ROM drives for software development 
purposes. Both HFS-compatible and non-HFS discs can be accessed with the driver 
using standard File Manager and Device Manager procedure and function routines. 


In addition, the AppleCD SC device driver monitors disc inserts and ejects, which 
gives the AppleCD SC drive the functional appearance of the familiar 800K drive. 
Other related activities, such as dragging the AppleCD SC icon to the trashcan to 
unmount and eject a disk, and selecting a file on an AppleCD SC, can also be done by 
using a standard SFGetFile dialog. For more information about standard file 
routines, suchas SFGetFile, see Inside Macintosh 


Macintosh applications communicate with these drives by executing certain operating 
system routines. The AppleCD SC device driver provides the software interface 
between the AppleCD SC and the Macintosh operating system. 


After the AppleCD SC device driver has been properly installed and initialized, any 
application can read data from a mounted AppleCD SC drive by issuing Device 
Manager calls. The Device Manager, part of the Macintosh operating system, controls 
device behavior by sending commands to the AppleCD device driver. The AppieCD 
device driver, in turn, sends specific activity requests to the AppleCD SC. The 
relationships in the device software environment are shown in Figure 2-1. 


2-2 Chapter 2: AppieCD SC Software (Alpha draft) 


subroutine specific 
calls and Device Mgr traps device 
parameters and parameter bik. commands 


the the the a 
application operating device Pans 
driver device 
data, data and data and 
status info, updated status info 
and error code parameter blk. 


Figure 2-1 
Device software environment 


The AppleCD SC device driver 


The AppleCD SC device driver functions are divided into three major functional 
areas: 


0 AppleCD SC device driver and device initialization 
0 Data acquisition and device control 
Q Disc insert event monitoring 


What follows is a narrative description of the activities in each of these areas. 


Appie CD SC device driver and device initialization 


The driver is initialized at boot time when the Macintosh is powered on. The AppleCD 
file in the System Folder contains a number of resources, as shown in Figure 2-2. The 
two which interest us are the ‘INIT’ and 'DRVR' resources. . 
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op SUStem Tolger - me 


AppleCD » 


DRVR Driver “AppleCD 


PREF ID = 32 


=C= INITs from ApplecD = 
INIT ID = 1 


Figure 2-2 
AppieCD device driver resources 


One procedure the System performs during startup is to look in the System Folder for 
all files of resource type ‘INIT. If one of these is found, the System will then look for an 
‘INIT’ resource in that file to load and execute. The AppleCD file meets this 
specification. 


The first task of the INIT routine is to look on the SCSI bus for CD-ROM drives. If the 
CD-ROM drive is powered on and appropriately answers both a SCSI Test Unit 
Ready command anda SCSI Inquiry command, a CD-ROM drive is recognized 
and considered to be active. If ther is no response to the Test Unit Ready 
command, the search continues with the next SCSI id. After the first drive is found, the 
"'DRVR' resource, the actual device driver, is loaded into system-heap memory and 
locked in place. Then the 'INIT installs the driver into the unit table, which is an array 
of driver references maintained by the operating system. After installing the driver 
into the unit table, the 'INIT' looks for additional CD-ROM drives assigned to other 
SCSI id numbers. If any are found, they are installed in the unit table as well. After this 
is complete, the TNIT' builds a parameter block, fills in the CD-ROM driver name, 
AppleCD, and passes a pointer to the parameter block inan Open call to the Device 
Manager. The Device Manager opens the driver by first filling in a few more fields in 
the parameter block, then locating and executing the driver's Open routine. Control 
eventually returns to the Device Manager and then to the ‘INIT’. All that is left is to 
return control to the System. 


& Note: If no CD-ROM drives are found, the 'INIT retums control to the System and 
the normal system startup process continues (executing other INITs, launching the 
Finder, and so on.). 
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By the time the Open routine is executing, the Device Manager has already put more 
information in the fields of the parameter block. One such field is the ioRefNum, a 
driver reference number the Device Manager computes based on the driver's position 
in the unit table. The Open routine uses this number and computes backwards, so to 
speak, to find out the SCSI id of the first CD-ROM found by the 'INIT. In fact, any time 
the driver gets control from the Device Manager, the SCSI id of the requested device is 
determined in this manner. The id is required by all the SCSI commands the driver 
sends to the CD-ROM drive. 


Because three different drives are supported, and certain SCSI commands differ from 
drive to drive, the Open routine next obtains manufacturer identification data from 
the drive it is currently looking at. Then, the drive is added to the drive queue anda 
flag, used elsewhere in the driver, is set to show that a drive is attached with the current 
SCSI id. 


Following this, the Open routine looks in the unit table for other CD-ROM drives. 
For each one found, the same procedure occurs: determine the drive's manufacturer, 
add the drive to the drive queue, and mark the related "cd" flag. 


After all drives have been processed, the Open routine installs a VBLTask in the 
vertical retrace queue which monitors both disc inserts and disc ejects once every half- 
second (discussed under Disc insert event monitoring). 


Finally, the Open routine returns control to the Device Manager. 


Data acquisition and device control 


As detailed in “The Device Manager’, chapter of Inside Macintosh, Volume 2, an 
application communicates with devices through the Device Manager. The Device 
Manager translates the application's requests into specific commands to the device 
driver. The driver, then, converts the commands into actual device activities. 


Applications may execute five basic Device Manager operations. Open calls give the 
driver an opportunity to allocate and initialize local variable space as well as 
performing any necessary device-startup operations. The Close call signals the 
driver to reverse the actions of the Open call by releasing local variable space back to 
the System. The Prime call is the data transfer call; in the case of CD-ROM, this is 
the Read call. Finally, Contzrol calls request that control information be sent to the 
device, while Status calls ask for information about the device. 


An application wishing to access a CD-ROM drive should first issue an Open call to 
the driver. The Device Manager will renirn the reference number corresponding to the 
first CD-ROM drive which the INIT’ routine located. at startup If the application next 
makes a WhoIsThere status call, the driver will report back the SCSI id's of any other 
drives. The related reference numbers can then be calculated and used in subsequent 
Device and File Manager calls. 
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The AppleCD SC device driver will not execute a Close request, except to retum a 
CloseErr return code. This is done to prevent closing any other mounted volumes. 
There are only two ways to close the driver: either remove the AppleCD file from the 
System Folder and power-down all the CD-ROM drives attached to the SCSI bus, or 
restart the Macintosh. 


After a volume's reference number has been determined, data may be read from the 
disc using either the high-level FSRead routine or the low-level PBRead driver 
call. 


In addition, there are both high- and low-level calls that send control information to 
the device (Control and PBControl), as well as corresponding calls to retrieve 
status information (Statu s and PBStatus). 


Individual Control and Status calls that the driver recognizes are described later in the 
AppleCD SC control and status calls section. 


Disc insert event monitoring 


The Macintosh video circuitry generates a vertical blanking interrupt sixty times a 
second when the electron beam in the monitor tube moves from the bottom to the top 
of the display. This regular interrupt is the Macintosh heartbeat and can be used to 
trigger the regular occurrence of a user-defined procedure. An application initiates 
this activity by building a VBLTask record describing both the procedure and how 
often to execute it, and installs this record in the VBLQueue. Then, every 1/60th of a 
second (or tick), if the requested elapsed time has elapsed, the user procedure will get 
contol. As previously mentioned, the Open routine installs such a VBLTask (the 
Task) to monitor CD-ROM disc inserting and ejecting. 


Two arrays of boolean flags indexed by SCSI id are initialized by the Open routine 
and maintained by the Task. The first of these indicates whether or not a CD-ROM 
drive is attached to a specific id. Obviously, if no CD-ROM drive is attached, the Task 
does no further processing with that id. 


The sécond array shows if a mountable disk was in the drive at the end of the last 
VBLtask execution. The success or failure of an attempt to communicate with an 
expected drive, combined with the mounted-last-time flag, yields a decision to 
mount, unmount or leave a drive as it is. Figure 2-3 presents the relationship between 
the flags in tabular format. 


2-6 Chapter 2: AppleCD SC Software (Aipha aroft) 


communication 


this time 
mounted 
UCCESS FAILURE 
last time aoa 
TRUE do nothing unmount disc 
FALSE mount new disc do nothing 
Figure 2-3 


Disc monitoring by the VBLTask logic 


Accessing the AppleCD SC driver from your 
application 


The current AppleCD SC driver installs itself when your system is booted up and is 
readily accessible by your application. To access the drive, your application needs 


only to open the driver, read data through the driver, and close the driver before your 
application terminates. 


“> Note: All program examples in this section are written in the C programming 
language. 

To open the driver, use the Macintosh OS command that follows: 

OSErr = OpenDriver(".AppleCD", &refNum) ; 


* Note for non-C programmers: The notation &refNum in the command example 
above means "address of refNum." Additionally, the period () in the driver 
name is correct and significant. 


If the call is successful (OSErr equals noErr), the short integer refNum will contain the 


reference number for the driver. This number must be used in succeeding calls to read 
the CD-ROM. 


Using the AppleCD SC driver 


The driver offers two ways to read sequential blocks of data from a CD-ROM drive: 
Macintosh OS routines and SCSI commands. SCSI commands are issued to the drive 
directly by the application with SCSI calls, and allow several operations in addition to 
reading blocks of data. 
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Macintosh OS routines 


CD-ROM data can be read using the command listed below or through the lower-level 
File Manager calls described later. 


OSErr = FSRead(refNum, count, &buffPtr) ; 


where refNum is the driver reference number, count is the (long) integer number of 
bytes to read, and buffPtr isa pointer to the location where the bytes are 
deposited. FSRead is a sequential read starting where the last operation left off. The 
File Manager call SetFPos may be used to change this position. (SetFPos sets the 
mark of the open file, whose access path is specified by refNum, to the position 
specified by posMode and posOff.) 


Standard Macintosh result codes are negative integers or zero (zero meaning “no 
error’). If OSErr = -36, then an I/O error was encountered. If this code is returned 
during a disk read, execute a Status call, as indicated below: 


OSErr = Status (refnum, csCode, &csParam) ; 


where refnum is the value which was returned by the OpenDriver call, csCode 
should equal 99, and csParam is a 22-byte record, which contain the sense-bytes 
describing the error condition which occurred. (For a description of the error codes 
returned by the driver, see Chapter 8, “AppleCD SC SCSI Commands”. For 
information about the sense-bytes, see the technical documentation for the CD-ROM 
drive you are using.) 


The low-level routine PBStatus can also be used to obtain sense bytes. 


Macintosh OS Device Manager routines 


Your development environment may require you to use low-level Device Manager 
routines. These routines function like the related routines presented above, but 
require the construction of an I/O parameter block before executing tie call. More 
information is available in both the “File Manager” and “Device Manager” chapters of 
Inside Macintosh, Volume II. 


The Macintosh SCSI Manager offers two different commands for reading data from the 
AppieCD SC, SCSIRead and SCSIRBlind The only difference between these two 
commands is the “handshaking” method used between the Macintosh and the CD- 
ROM drive. During a SCSIRead operation, handshaking occurs after each byte is 
transferred. When the SCSIRBlind command is executing, handshaking takes 
place only for the first byte of each block of data transferred. 


The following tells the AppleCD SC driver which read command to use 


OSErr = Control(refNum, csCode, &csParam) ; 


where refNum is the value returned by the OpenDriver call, csCode should equal 
78, and csParam is an integer Boolean variable which will be TRUE for 
SCSIRBlind or FALSE for SCSIRead reads. 
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Using the AppleCD SC SCSI routines 


If you need to exercise more control over your drive than the Macintosh OS routines 
offer, your application will need to execute SCSI commands directly to the drive. To 
use the AppleCD SC SCSI commands effectively, you should be familiar with the 
following documents: 


© ANSI X3T9.2 Committee SCSI Specification, Revision 17b 
© Inside Macintosh, Volume IV, Chapter 13, “The SCSI Manager” 
Q The AppleCD SC SCSI commands described in Chapter 8 of this document 


*> Note: You will still open the driver using the Macintosh OS routine described 
earlier in this document. 


The basic Macintosh OS Control routine used to pass SCSI commands through the 
SCSI Manager to the CD-ROM drive is given below: 


OSErr = Control (refNum, csCode, &csParam) ; 


where csCode must equal 77. This code tells the device driver to build and execute a 
SCSI command based on the data to follow. csParam is a block of data with the 
following structure: 


struct csParam { /* csParam structure */ 

char *cspComBlkAddr; /* Address of SCSI command Block */ 

char *cespPProgAddr; /* Address of pseudo-program or NIL 
if no transfer */ 

char *cspBufAddr; /* buffer address for transfer or 
NIL if no transfer */ 

long cspTransSize; /* Size of transfer in bytes or NIL 
if no transfer */ 

long cspTicks; /* Ticks to wait until completion */ 

char cspComBlkSize; /* Size of the command block that we 


are sending */ 
} 


* Note: The signed value of the cspTransSize (size of transfer in bytes) field 
indicates the direction of data transfer, as listed in Table 1. | 


Table | 
Description of the signed value In the cspTransSize fleid 


Sign Deseription of signed value 


eck ck a EEE 
(0) no bytes are being transferred 

(+) reading data 

(-) writing data to the drive (actually writing parameters to the controller) 
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AppleCbD SC driver control and status calls 


Control calls send information to the device driver, while Status calls request 
information from the driver. 


The high-level Control and Status calls have a similar format Each requires three 
parameters: first, refnum is the driver reference number returned by the Open cal. 
Next, csCode tells the driver what type of information is being sent or requested, 
and last, csParamPtr points to the information itself. The format of the calls is: 


OSErr TheCall (refnum, csCode,csParamPtr) 
int refnum, csCode; 
char *csParamPtr; 


where TheCall is either a Control or Status call. It can also be seen that both calls 
return a result code, OSErr, to the calling routine. 


If the application programmer chooses, low-level Control and Status routines can be 
used as well. With low-level calls, the routine parameters to be passed to the driver are 
contained in a parameter block. The format of the parameter block is well-defined in 
Inside Macintosh and will not be repeated here. The variables passed in the high-level 
calls are placed in the parameter block before the low-level call is executed. The low- 
level call format is: 


OSErr ThePBCall (paramBlkPtr, asynch) 
char *paramBlkPtr; 
int asynch; 


where PBCallName is either PBControl or PBStatus, paramBlock points to the parameter 
block, and asynch is always FALSE. 


The high-level calls can be used when there is only one-way transfer of information as a result of the call. 
Others, like ReadTOC for example, function both like a Control call and like a Status call. That is, 
control information is passed to the drive in the csParam area, and status information is found by the 
caller in the same data area after the call has completed. High-level Control and Status calls cannot be 
used for these calls; low-level Control and Status routines must be used instead. 
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Control cails 


The list of Control and Status calls are presented in the following format: 


Call Name (csCode) 


Description: 
Input: 


Output: 


return codes: 


Verify (5) 


Description: 


Inputs: 


return codes: 


Format (6) 
Description: 


Inputs: 


return codes: 


Eject (7) 


Description: 


Inputs: 


a brief statement of the purpose or function of the call. 
a list of the contents of csParam passed to the call if any. 
a list of the contents of csParam returned by the call if any. 


all codes which could be returned by the call. 


The control call Verify reads each block, looking for non- 
readable blocks. Not used in the CD-ROM driver. The driver will 
return NoErr. 


none 
NoErr No error 
badUnitErr Bad reference number 


unitEmptyErr Bad reference number 
notOpenErr _ Driver is not open 


The control call Format prepares device media for data 
storage. CD-ROM discs are read-only so this call will return an 
error. 


none 


badUnitErr Bad reference number 
unitEmptyErr Bad reference number 

notOpenErr Driver is not open 

controlErr Driver can't respond to this Control call 


The control call Eject causes the AppleCD SC drive to eject 
the disc. Only supported by Apple and Toshiba drives. If the 
driver is controlling a Philips drive, NoErr will be returned. 


none 
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return codes: 


Mediaicon (21) 
Description: 


Inputs: 
Outputs: 


return codes: 


Drivelcon (22) 
Description: 


Inputs: 
Outputs: 


return codes: 


Driveinfo (23) 
Description: 


Inputs: 


Outputs: 


return codes: 
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NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr _ Driver is not open 


The control call MediaIcon retums a pointer to an icon list 
and a name string to caller. 


none 


esParam +0 pointer to icon list and name string 
NoErr No error 

badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr _— Driver is not open 


The control call DriveIcon returns a pointer to an icon list 
and a name string to caller. 


none 


csParam +0 pointer to icon list and name string 
NoErr No error 

badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


The control call DriveInfo returns about drive's physical 
location, size, and other characteristics to caller. See Inside 
Macintosh, Volume V. 


none 

csParam +0 byte 0: 1 indicating “unspecified drive" 
byte 1: 14 indicating secondary drive, 
removable, SCSI, external. 

NoErr No error 

badUnitErr Bad reference number 


unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
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SCSI (77) 


Description: 


Inputs: 


return codes: 


RSwitch (78) 
Description: 


Inputs: 


return codes: 


VarBik (79) 


Description: 


Inputs: 


return codes: 


The control call SCSI lets an application send a SCSI command 
directly to the CD-ROM drive. Ifan ioErr error is returned, 


execute a GetSense Stans call (given later) to retrieve sense 
bytes returned to driver from drive. 


csParam +0 address of SCSI command string 

csParam +4 address of Transfer Instruction block or NIL 

esParam +8 reserved (4 bytes of 0) 

csParam +12 an integer value; 1 = read and -1 = write 

esParam +14 reserved (2 bytes of 0) 

csParam +16 number of ticks (1/60 sec) to wait before 
completion phase is started 

csParam +20 length of SCSI command string (word) 


NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr _— Driver is not open 
ioErr Input/Output error 


The control call RSwitch lets an application specify whether 
polling for new data on the SCSI bus will occur only at the 
beginning of blocks, or for each byte during read commands. 


cesParam+0 TRUE = polling on each block 
FALSE = polling on each byte 


NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr _— Driver is not open 


Each of the CD-ROM drives controlled by this driver support 
variable block sizes. The control call VarBlk sets the device 
block size. 


csParam+0 the blocksize (integer). Legal blocksizes in bytes 
are 512, 256, 1024, 2048, 2336, and 2340 for the 
AppleCD SC and Toshiba drives. The Philips 
sizes are the same except for 2340 bytes; on the 
Philips CM 110 drive this becomes 2352 bytes. 


NoErr No error 


UserEject (80) 


Description: 


Inputs: 


Outputs: 


return codes: 


VBLFrequency (81) 


Description: 


Inputs: 
Outputs: 


return codes: 


ReadTOC (100) 


Description: 


Inputs: 
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badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr __ Driver is not open 
paramErr invalid blocksize parameter 


The control call UserEject enables or disables the eject 
button on the drive, as well as the SCSI Eject command. Valid 
only on the AppleCD SC and Toshiba drives. If used with Philips 
drive, driver will return controlErr. 


word sized 
1: enables button eject (default) 
2: disables button eject 


csParam +0 


none 
NoErr No error 
badUnitErr Bad reference number 


unitEmptyExr Bad reference number 
notOpenErr Driver is not open 
controlErr Driver cannot respond to this call 


The control call VBLFrequency permits the user to control 
how often the "disk in place" VBLtask is executed. Probably 


most useful when debugging. 

csParam +0 number of ticks (word) 
none 

NoErr No error 
badUnitErr Bad reference number 


unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


Read Table of Contents, ReadTOC, returns table-of -contents 

information depending on the type of request. 

csParam +0 type of ReadTOC call (word-sized): 

1; return first and last user track number in BCD. 

2: retum address of Lead Out area in BCD 
Min-Sec-Frame. 

3: return starting addresses for user-specified 
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atten, 


range of tracks. 


For type#1 and type#2 calls, the data will be retuned directly in 
the csParam field. With type#3 calls, the user must allocate 
space for the data which the drive will return. 


The following parameters are also required for type#3 calls: 


csParam +2 Address of data buffer dong word) 
esParam +6 Length of data buffer (word) 
csParam +8 starting track number (byte) 


The number of tracks for which information is requested will be 
calculated from the length of the allocated space. 


Outputs: For type #1 calls: csParam +0 first user track number in BCD 
csParam +1 last user track number in BCD 
csParam +2 0 
csParam +3 0 


For type #2 calls: csParam +0  Lead-out starting area address 


in BCD (MIN) 

esParam +1  Lead-out starting area address 
in BCD (SEC) 

csParam +2 Lead-out starting area address 
in BCD (FRAME) 


csParam +3 0 


For type #3 calls: Four bytes of data will be returned in the user- 
specified buffer for each track in the following 


format: 
byte: content: 
0 control field of specified track 
1 track start MIN in BCD 
2 track start SEC in BCD 
3 track start FRAME in BCD 
return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr bad parameter error 
controlErr Driver can't respond to this Control call 


Read@ (101) 


Description: The control call ReadQ returns the current Q Subcode address 
data in csParam 


Inputs: 


none 


Outputs: csParam 


ecsParam 
csParam 
csParam 
csParam 
csParam 
csParam 
csParam 
csParam 


return codes: NoErr 


badUnitE 


unitEmptyErr 
notOpenErr 


paramErr 


controlErr 


ReadHead (102) 


Description: 


Inputs: 


+0 
+1 
+2 
+3 
+4 
+5 
+6 
+7 


+8. 


rr 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control cail 


The control call ReadHeader returns absolute address and 


mode information about a specific logical block. This cail is valid 
only for blocks in data tracks. If a requested block is in an CD- 
Audio (Red book) section of the disc, an error will be returned. 


csParam 


Outputs: csParam 


csParam 
csParam 
csParam 


return codes: NoErr 


badUnitErr 
unitEmptyErr 
notOpenErr 


paramErr 


controlErr 


ATrkSearch (103) 


Description: 


Inputs: 
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+0 


+0 
+1 
+2 
+3 


logical block number (word) 


absolute time AMIN 
absolute time ASEC 
absolute time AFRAME 
MODE 


No. error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call ATrkSearch positions the optical pickup at 


the specified audio address. An paramEnrr error will be retumed if 
the address is not in an audio area of the disc. 


csParam 


+0 


Address type (word): 
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Outputs: 


return codes: 


APtay (104) 


Description: 


Inputs: 


csParam +2 


csParam +6 


csParam +8 


none 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


0: 
1: 


2: 


search address in logical block format. 
search address in AMIN, ASEC, 
AFRAME format. 

search address in TNO format. 


Search Address Gong word): 


from MSB in byte 2 to LSB in byte 5 


Play Flag (word): 


0 = search and pause at address. 
non-0 = play according to play mode. 


Play Mode (word): 


lower four bits make up mnemonic for 
play mode. The right two bits (0 and 1) 
stand forsspeaker right channel output 
from left and right channel! input; the 
left two bits (2 and 3) stand for speaker 
left channel output from left and right 
channel input; such as, 

0000B Muting 

0001B = R thru R only 

0011B L/Rthru R only 

1001B_ = Lthru L, R thru R (stereo) 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call APlay positions optical pickup at specified 
audio address and begins playback in specified play mode when 
address is found. Error is returned if address is not in audio area 


of disc. 


csParam +0 


ecsParam +2 


csParam +6 


Address type (word): 


0: search address in logical block 
format. 

1: search address in AMIN, ASEC, 
AFRAME format. 

2: search address in TNO format. 


Search Address Gong word): 


from MSB in byte 2 to LSB in byte 5 


StopAddress Flag (word): 


0 = the Playback Address is a starting 
address. In this case, the stop address 
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return codes: 


APause (105) 


Description: 


Inputs: 


Outputs: 


return codes: 


AStop (106) 


Description: 


csParam +8 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


should have been set by a prior Audio 

Stop command. 

non-0 = the Playback Address is a 

stopping address. Here, the starting 

address is set by an earlier Audio 

Search command with Play flag = 0. 
Play Mode (word): 

lower four bits make up mnemonic for 

play mode. The right two bits (0 and 

1)stand for speaker right channel output 

from left and right channel input; the 

left two bits (2 and 3) stand for speaker 

left channel output from left and right 

channel input; such as, 

0000B Muting 

0001B R thru R only 

0011B L/R thru R only 

1001B L thru L, R thru R (Stereo) 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call APause starts or stops current audio play 


operation. 


csParam +0 


none 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


long word 

1 = enter hold state and mute audio 

0 = release pause and resume play at next 
block 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The control call AStop specifies audio address at which audio 


play will stop. 
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Inputs: 


Outputs: 


return codes: 


AStatus (107) 


Description: 


Inputs: 


Outputs: 


esParam +0 Address format (word): 
0 = logical block address 
1 = minute-second-frame address 
2 = track number address 
csParam +2 Address Gong word) 
none 
NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 
paramErr bad parameter error 
controlErr Driver can't respond to this Control call 


The control call AStatus returns status data of current audio 
block. If drive is not in "ready" condition, ioErr error will be 
returned. The application may then call GetSense to request 
sense bytes describing problem. If AStatus is called while the 
drive is reading a data block, ioErr will be returned. 


none 
csParam +0 Audio Status byte: 

0 = audio play in progress 

1 = audio pause in operation 

2 = audio muting on 

3 = audio play operation completed 
csParam +1 Play Mode: 


0 =play with muting on 
1 = play right chan thru right chan only 

2 = play left chan thru right chan only 

3 = play I/r chan thru right chan only 

4 = play right chan thru left chan only 

5 = play right chan thru left and right 

6 = play r chan thru left, left chan thru right 
7 =play r chan thru], I/r thru r chan 

8 = play! thru! only 

9 = play | thru | chan, r thru r chan (stereo) 
10 = play | thru |, r thru | 

11 = play | thru |, I/r thr 

12 = play I/r thru | 

13 = play I/r thru |, r thru r 

14 = play l/r thru |, | thru r 

15 = play L/r thru |, l/r thru r (mono) 
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esParam +2 


esParam +3 
csParam +4 
csParam +5 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


return codes: 


ASean (108) 
Description: 


Control field of next track: 
bits 
3210 ~— function 
00x0 2 audio chan without pre-emphasis 
00x1 2 audio chan with pre-emphasis 
10x0 4 audio chan without pre-emphasis 
10x14 audio chan with pre-emphasis 
Olxi data track 
Olxl reserved 
lixx reserved 
xx0x = digital copy prohibited 
xxlx digital copy permitted 

next track starting address (AMIN) 

next track starting address (ASEC) 

next track starting address (AFRAME) 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 


The contro! call AScan will perform a fast-forward or fast- 


reverse scan operation starting from specified address. 


Inputs: csParam +0 


csParam +2 


Outputs: none 


return codes: NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 
paramErr 
controlErr 


Address type (word): 

0: search address in logical block 
format. 

1: search address in AMIN, ASEC, 
AFRAME format 


2: search address in TNO format. 
Search Address dong word): 
from MSB in byte 2 to LSB in byte 5 


No error 

Bad reference number 

Bad reference number 

Driver is not open 

bad parameter error 

Driver can't respond to this Control call 
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Status calls 


DiskStatus (8) 
Description: 


Inputs: 


Outputs: 


return codes: 


WholsThere (97) 


Description: 


Inputs: 


Outputs: 


return codes: 


GetSize (98) 


The DiskStatus call is used by the system to learn various 
attributes about the mounted disc. 


none 


csParam +0 
csParam +2 
ecsParam +3 
csParam +4 
esParam +5 
csParam +6 
esParam +10 
csParam +12 
csParam +14 
csParam +16 
csParam +18 
esParam +19 
csParam +20 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 


track 0 
WriteProtect 128 
diskInPlace 1=yes 0=no 
installed 1 

sides 1 

qLink NIL 

qType 0 

dQDrive drive number 


dQRefNum drive reference number 
dQFSID 1 

twoSideFmt 0 

needsFlush 0 

diskErrs 0 

No error 


Bad reference number 
Bad reference number 
Driver is not open 


WhoIsThere lets an application know what SCSI ids have CD- 


ROM drives assigned. 


none 


csParam +0 
csParam +1 


NoErr 
badUnitErr 
unitEmptyErr 
notOpenErr 


0 


bits 0 thru 7 correspond to SCSI ids 0 thru 7. 


If a bit equals 1, the corresponding SCSI id 
has a CD-ROM drive assigned to it. 


No error 

Bad reference number 
Bad reference number 
Driver is not open 
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Description: GetSize returns the currently assigned logical block size. 


Inputs: none 

Outputs: esParam +0 block size (word) 

return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 

GetSense (99) 
Description: GetSense returns current sense bytes to calling application. 


Number of bytes returned depends on drive used. For the 
AppleCD SC and Toshiba drive, 18 bytes should be expected. For 
Philips, 4 bytes will be returned. Calling application should make 
this call after receiving ioErr return code. 


Inputs: none 

Outputs: csParam +0 4 to 18 bytes of sense data 

return codes: NoErr No error 
badUnitErr Bad reference number 
unitEmptyErr Bad reference number 
notOpenErr Driver is not open 


Apple Il AppleCD $C SmartPort control call 
descriptions 


This section provides the AppleCD SC control call descriptions. Note that the 
parameter list format for the AppleCD SC control calls is the same as described in the 
Firmware command definitions section of the Apple If SCSI Card Technical 
Reference Manual unless otherwise defined in the control call descriptions. 


* Note: To fully understand and implement the AppleCD SC conwol calls described 
in this section, you need to refer to the description of the Apple II SCSI Card 
SmartPort firmware provided in the Applell SCSI Card Technical Reference | 
Manual. 


Table 2-1 shows the control codes and their associated routine or SCSI command, with 
the SCSI operation code Cif any) given in parenthesis. 


Table 2-1 
Control codes 
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$29 
$2A 


Eject ($04) 


Definition 


Eject ($CO) 
TestUnitReady ($00) 
RequestSense ($03) 
ModeSelect ($15) 
ModeSense ($1A) 
ReadCapacity ($25) 
SendDiagnostic ($1D) 
Inquiry ($12) 
SetBlockSize 
SetTimeout 
ExtendedSeek ($2B) 
ReceiveDiagnostic ($1C) 
StartUnit ($1B) 
StopUnit ($1B) 
PreventRemoval ($1E) 
AllowRemoval ($1E) 
Verify ($2F) 
RezeroUnit ($01) 
Patch1Call 
SetNewSDAT 
AudioSearch ($C8) 
AudioPlay ($C9) 
AudioPause ($CA) 
AudioStop ($CB) 
AudioStatus ($CC) 
AudioScan ($CD) 
Eject ($C0) 

ReadTOC ($C1) 
ReadQSubcode ($C2) 
ReadHeader ($C3) 
Setinterleave ($04) 


Description: The SmartPort Eject control code executes the SCSI Eject 


($C0) command. The parameter list for this control code is as 


follows: 

Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($04) 
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TestUnitReady ($05) 


Description: 


The TestUnitReady SmartPort control code executes SCSI 
Test Unit Ready ($00) command. The parameter list for 


this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($05) 


RequestSense ($06) 


Description: 


control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer Usb—msb) 

4 control code ($06) 


ModeSelect ($08) 


Description: 


control code is as follows: 


Byte Definition 

0 parameter list length ($04) 
1 unit number 

2-3 buffer pointer dsb—msb) 

4 control code ($08) 

5 transfer byte count 


ModeSense ($09) 


Description: The ModeSense SmartPort control code executes the SCSI 
Mode Sense ($1A) command. The parameter list for this 
control code is as follows: 

Byte Definition 
0 parameter list length ($04) 
1 unit number 
2-3 buffer pointer (sb—msb) 
4 control code ($09) 
5 transfer byte count 
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The RequestSense SmartPort control code executes the SCSI 
Request Sense ($03) command. The parameter list for this 


The ModeSelect SmartPort control code executes the SCSI 
Mode Select ($15) command. The parameter list for this 


ReadCapacity ($0D) 


Description: 


The ReadCapicity SmartPort control code executes the SCSI 


Read Capacity ($25) command. The parameter list for this 
control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb—msb) 
6 control code ($0D) 


SendDiagnostic ($0E) 


Description: 


Inquiry ($OF) 


Description: 


SetBlockSize ($13) 
Description: 


The ReadDiagnostic (SOE) SmartPort control code 
executes the AppleCD SC SCSI Send Diagnostic ($1D) 
command. The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2~3 reserved 

4 control code ($0E) 


The Inquiry (SOF) SmartPort control code executes the 


AppleCD SC SCSI Inquiry ($12) command. The parameter 
list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb—msb) 

4 control code ($0E) 


The SetBlockSize ($13) SmartPort control code sets the 
number of bytes per block on the AppleCD SC. The parameter list 
for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 block size (bytes) msb-Isb 
4 control code ($13) 
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SetTimeout ($14) 
Description: 


Seek ($16) 
Description: 


The SetTimeOut ($14) SmartPort control code sets the 
amount of time the initiator will wait for a response from the target 
before terminating the command (timeout). The timeout 
constant ranges from $00-SFF, and is loaded into the Control 
call parameter list in byte 2. For this command, byte 3 of the 
parameter list must be set to 0. The default timeout constant is 
$08, for a timeout duration of approximately 10 seconds. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2 timeout 

3 reserved ($00) 

4 control code ($14) 


The Seek ($16) SmartPort control code executes the Apple 
CD SC SCSI Extended Seek ($2B) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 seek address buffer pointer 
6 control code ($16) 


ReceiveDiagnostic ($17) 


Description: 
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The ReceivedDiagnostic ($17) SmartPort control code 
executes the AppleCD SC SCSI Receive Diagnostic 


Results ($1C) command. The parameter list for this control 
code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb-msb) 
4 control code ($17) 
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StartUnit/StopUnit ($18/$19) 


Description: 


These codes execute the AppleCD SC SCSI Start/Stop Unit 
($1B) command. Each must be used separately; StartUnit 
($18) only starts the unit, while StopUnit ($19) only stops 
it The parameter list for these control codes is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($18/$19) 


PreventRemoval/AllowRemoval ($1A/$1B) 


Description: 


Verity ($1C) 


Description: 


RezeroUnit ($1D) 
Description: 


These codes execute the AppleCD SC SCSI Prevent/Allow 
Removal ($1E) command. Each must be used separately. The 
parameter list for these control codes is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($1A/$1B) 


The Verify ($1C) SmartPort control code executes the SCSI 


Verify ($2F) command. The parameter list for this control 
code is as follows: 


Byte Definition 

0) parameter list length ($03) 
1 unit number 

2~5 reserved ($00) 

6 control code ($1C) 


The RezeroUnit ($1D) SmartPort control code executes the 


SCSI Rezero Unit ($01) command. The parameter list for 
this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 reserved ($00) 

4 control code ($1D) 
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Patch 1Call ($1E) 


Description: This code is used to patch one unsupported command to the 
command interpreter. It executes program code loaded into RAM 
bank 2 at $C803. To use this call, you must write the program 
code, exactly as you want it to execute, into bank 2 RAM starting at 
$C803. Once you have loaded the program code, executing 
Patch1Call will automatically execute your command. 


Important 


Remember that your command Is loaded In RAM: any reinitialization or loss of 
power will erase It. 


The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 reserved ($00) 

2-3 reserved ($00) 

4 control code ($1E) 


SetNewSDAT ($1F) 


Description: This code forces the SCSI card to reinitialize the SDAT and 
DIBTAB device tables for all devices resident on the SCSI bus. 
The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 

1 unit number (any valid unit number will work) 
2-3 RAM address pointer 

4 control code ($1E) 


AudioSearch ($20) 


Description: The AudioSearch ($20) SmartPort control code executes 
the AppleCD SC SCSI Audio Track Search ($C8) 
command. The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer 

6 control code ($20) 
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AudioPlay ($21) 
Description: 


AudioPause ($22) 


Description: 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 play flag (=hold after search, 1=play after search) 
1 play mode ($00-$FF) 

2-5 search address (sb—msb) 

6 type ($00-$02) 


The AudioPlay ($21) SmartPort control code executes the 
AppleCD SC SCSI Audio Play ($C9) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb-msb) 
6 control code ($21) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 stop flag (O™stop address in 2~5, 1=play address) 
1 play mode ($00~—SFF) 

2-5 playback address (sb—msb) 

6 type ($00-$02) 


The AudioPause ($22) SmartPort control code executes the 
AppleCD SC SCSI Audio Pause (SCA) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb-msb) 
6 control code ($22) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 
0 pause flag (O=pause, 1=resume) 
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AudioStop ($23) 
- Description: 


AudioStatus ($24) 
Description: 


AudioSean ($25) 
Description: 


The AudioStop ($23) SmartPort control code executes the 
AppleCD SC SCSI Audio Stop ($CB) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb~msb) 

6 control code ($23) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 
0-3 stop address (msb-Isb) 
4 type ($00-$02) 


The AudioStatus ($24) SmartPort control code executes 
the AppleCD SC SCSI Audio Status ($CC) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb—msb) 
6 control code ($24) 


The AudioScan ($25) SmartPort control code executes the 
AppleCD SC SCSI Audio Scan ($CD) command. The 
parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-5 buffer pointer (sb—msb) 

6 control code ($25) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 direction flag (0=forward, 1=reverse) 
1 reserved ($00) 

2-5 scan start address (sb-msb) 

6 type ($00-$02) 
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ReadTOC ($27) 
Description: 


The ReadTOC ($27) SmartPort control code executes the 
AppleCD SC SCSI Read Table of Contents ($C1) 
command. The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (isb-msb) 
4 control code ($27) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 

0 track number 

1-2 allocation length (sb—msb) 
3 type ($00-$02) 


ReadQSubcode ($28) 


Description: 


The ReadQSubcode ($28) SmartPort control code executes 
the AppleCD SC SCSI Read Q Subcode ($C2) command. 
The parameter list for this control code is as follows: 


Byte Definition 

0 parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb-msb) 
4 control code ($28) 


ReadHeader ($29) 


Description: 


The ReadHeader ($29) SmartPort control code executes the 
AppleCD SC SCSI Read Header ($C3) command. The 
parameter list for this control code is as follows: 


Byte Definition 

) parameter list length ($03) 
1 unit number 

2-3 buffer pointer (sb—msb) 
4 control code ($29) 


The buffer contains the control parameters required by the SCSI 
command for proper execution, as follows: 


Byte Definition 
0-3 block address 
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High Sierra and 
AppleCD SC 


This chapter includes a brief overview of the High Sierra file system and how High 
Sierra presents files to the Macintosh or Apple IIGS user. 


The High Sierra file system 


High Sierra is a standard that specifies a hierarchical volume and file structure for CD- 
ROMs. The purpose for High Sierra is to provide a CD-ROM file structure that is not 
dependent on a particular operating system. The High Sierra file system allows for the 
interchange of information between any number of computer operating systems that 
are configured to recognize and translate the High Sierra structure. 


Three similar formats exist; they are the May 28, 1986, Working Paper for 
Information Processing—Volume and File Structure of Compact Read Only Optical 
Discs for Information Interchange (commonly referred to as High Sierra) published 
by the CDROM Ad Hoc Advisory Committee, the purposed ISO 9660 ISO 
Cnternational Standards Organization) Standard, and the European Computer 
Manufacturers Association ECMA-119 Standard. 


The complete specification for the High Sierra, ISO, or ECMA standard will not be 
repeated in this document. If you plan to develop your CD-ROM product in one of 
these formats, you will need to reference the appropriate specifications for 
compatibility testing. 


> Note: In May of 1982, a group of computer technology experts from Apple, DEC, 
Sony, and other leaders in the computer industry (referred to as the Ad Hoc 
Committee), gathered at Del Webb's High Sierra Casino in Stateline Nevada. 
Their purpose was to write a paper that described a file and volume structure for 
CD-ROM that could be universally read from any computer operating system. 
Hence, the name “High Sierra” was selected for the file format.. 


High Sierra on the Macintosh and Apple Il 


CD-ROMs developed with the High Sierra May 8 or ISO 9660 file structures will be 
recognized by future releases of the Macintosh and Apple IIGS computer operating 
systems. The Macintosh and Apple IIGS systems will provide a transparent application 
interface to High Sierra structured CD-ROMs. The interfaces will allow access to High 
Sierra files through standard Macintosh or Apple IIGS system calls. 


The High Sierra file system transiation software in the Macintosh and Apple IGS 
systems will support single High Sierra volumes on a CD-ROM. The High Sierra 
volumes can be of any size, as long as only one volume exists on the disc. Other 
implementation specific details for the Macintosh and Apple Ilgs High Sierra file 
system translators will be released in a future revision of this document. 
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High Sierra on the Macintosh and Apple lics desktop 


High Sierra files and directories on High Sierra discs will appear on the desktop with 
the standard default file and folder icons. You will be able to display files and folders 
in each of the modes available from the View menu. The View menu modes are: by 
Icon, by Name, by Date, by Size, and by Kind. More information about the user 
interface and implementation-specific details for High Sierra on Macintosh and 
Apple IIGS computers will be included in a future release of this document. 


High Sierra on Apple Ils 


Apple 0 computers, other than the Apple IGS, will have a set of High Sierra utility 
routines, which will allow applications to read High Sierra CD-ROMs. The Apple I 
High Sierra utility routines must be specifically called by the application. More 
information-specific details for High Sierra on the Apple II will be included in a fumre 
release of this document. 
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Why CD-ROM and HyperCard? 


Just as CD-ROM is an ideal method to distribute vast amounts of diverse data, 
HyperCard is an excellent way to organize and display this information. 


Perhaps the single most interesting advantage HyperCard offers you as a developer is 
the opportunity to present users with a consistent interface — something currently 
lacking in the CD-ROM world. And, because HyperCard is bundled with all of the 
Macintosh CPUs, it’s a interface familiar and available to a huge customer base. 


Another development advantage is HyperCard’s easily programmable graphic 
Macintosh interface—one that utilizes all of the toolbox routines. HyperCard allows 
you to construct your Macintosh interface more quickly than if you programmed it in 
Pascal or C. Hence, your software development time and cost will be reduced 
significandy. You will not have to spend a lot of time learning how to program the 
Macintosh from scratch. 


For example, if you choose to use HyperCard as an interface, you can put the majority 
of your effort into the content and functionality of your database. The user ends up 
with the familiar point and click environment rather than a series of complicated 
command lines and function keys.Best of all, HyperCard is flexible and extensible 
enough to let you do the things you do best! 


In addition, your existing products can be inexpensively moved into the Macintosh- 
HyperCard environment in one of two ways: (1) by producing HyperCard stacks and 
using your talents and existing software to produce an innovative, easy-to-use retrieval 
engine for HyperCard or (2) by porting the internals of your product over to the 
Macintosh, then utilizing the HyperCard external command feature (described later) 
and graphic interface. 


Even without using HyperCard extensions or creating a new retrieval engine, 
HyperCard provides an excellant platform from which to publish on a CD-ROM. 
HyperCard stacks, which provide the user with buttons and easy to follow links to your 
data, can be put on CD-ROM. HyperCard then reads the stacks on the CD-ROM and 
presents your data to the user without any changes. _ 


HyperTalk: the HyperCard authoring language 


HyperTalk is the powerful and easy-to-use authoring language for HyperCard, 
providing the tools to build the visual and interactive retrieval models possible with 
HyperCard. It activates HyperCard, and is the glue you use to link the various parts of 
your stack together. HyperTalk allows you to control the actions of HyperCard objects: 
buttons, fields, cards, backgrounds, and stacks. 
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You use HyperTalk to send messages to and from HyperCard objects. A message can 
be generated by a click of the mouse, the opening of a card, a statement typed into the 
Message box, or other event. How a given object responds to a particular message 
depends on its script, and all HyperCard scripts are written in HyperTalk. 


* Note: HyperCard is not a classic object-oriented programming system, although it 
implements some object-oriented concepts, such as message passing and objects 
themselves. : 


This document provides a high level overview of HyperCard concepts. For a more 
comprehensive description of HyperCard and the HyperTalk language, see the 
HyperCard Script Language Guide, available from the Apple Programmer's and 
Developer's Association (APDA), and The Complete HyperCard Handbook, by 
Danny Goodman. 


HyperCard Objects 


There are five kinds of objects in HyperCard: buttons, fields, cards, backgrounds, 
and stacks. (Examples of HyperCard objects are shown in Figure 4-1.) The basic unit 
of information is the card: when you look at the screen of a Macintosh™ computer 
running HyperCard, what you see foremost is a card. Each card is associated with a 
background, and a background may be (and usuaily is) shared by more than one card. 


HyperTalk: the HyperCard authoring language 
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This is the first card in the Stack 


FLOWER we LEAP 
SHAPE SHAPE 


LANCEOLATE 


Figure 4-1 
HyperCard objects 


The card overlays the background; both are the size of the card window, which is the 
size of the original Macintosh screen. What you see in the card window belongs to the 
card, or, if the card is ansparent, to the background The card and background both 
contain pictures—the arrangement of pixels that define their appearance. Cards are 
grouped in stacks, which are Macintosh files. The layers of objects that make up what 
you see in HyperCard are shown in Figure 4-2.. 


4-4 Chapter 4: HyperCard and CD-ROM (Aipha draft) 


Background Shared Shared Card Card Card What 
Picture Fields Buttons Picture Fields Buttons You See 


The background and card pictures are in any order within the card or background 


in fixed positions. Other objects can be and can be transparent or opaque. 
Figure 4-2 


The layers of HyperCard objects on cards and backgrounds 


Cards and backgrounds also contain buttons and fields. Buttons are action objects or 
“hot spots” on the screen—when you click a button with the Browse tool, something 
usually happens. For example, clicking a button can take you to the next card ina 
stack. Fields carry editable text: suings of characters. The Browse tool hand pointer 
changes to an I-beam when it's positioned over a field of unlocked text, enabling you 
to manipulate the text with it. All editable text in HyperCard is carried in fields. (There 
may also be characters on the card or background which are Paint text. Such 
characters are not editable once they are placed; they are part of the picture on the 
card or background.) 


When HyperCard is running, its environment of objects consists of one open (or 
visible) card, that card’s background, the buttons and fields belonging to the card and 
those belonging to the background, the stack they are all in, all the objects in other 
stacks on disks and servers connected to your Macintosh, and HyperCard itself. 


HyperTalk: the HyperCard authoring language 


Note: HyperCard also keeps track of the rest of the Macintosh environment: other 
applications and their documents, I/O devices such as disk drives and modems, 
and so on, but HyperCard doesn’t treat these entities as objects. Some HyperCard 
commands, such as Dial, Open, and Write, deal directly with the external 
environment, and you can extend HyperCard with your own external commands 
and functions. External commands and functions are described in the section, 
“HyperCard External Commands.” 


Messages 


HyperCard objects interact with each other, with the user, with HyperCard, and with 
the Macintosh environment, by sending messages. Some messages are descriptions of 
things that happen in the environment, such as that the mouse has been clicked or a 
card opened. These are system messages; flashes announced to the community of 
objects. For example, if you click the mouse button down, HyperCard generates the 
message mouseDown, and when you let the mouse button up, it generates the message 
mouseUp. Messages are sent to various objects in turn, depending on the position of 
the objects, the nature of the message, and other conditions. For example, mouse 
click messages go first to the topmost button or field (if any) under the pointer on the 
screen. Next the message goes to the card, the background, the stack, the Home stack, 
and finally to HyperCard itself. 


HyperTalk command statements are also messages—orders to do some particular 
thing, like add two numbers or go to another card. A command, whether executed in a 
script or typed into the Message box, is always sent as a message. 


Scripts 


How any object responds to a message depends on its script, and every HyperCard 
object has a script (although it can be completely empty). Each line of a script is a 
HyperTalk statement, defined by a carriage return at its end. The first word of a 
statement is either a control word, such as on, which makes the statement a control 
statement, or it’s a command, such as go, which makes the statement a command 
statement. Control statements determine how scripts execute, and command 
statements are sent as messages to other objects in the HyperCard environment. The 
syntax of the rest of the statement following the first word depends on the particular 
control word or command. 


A script consists of any number of control structures called handlers, A simple 
handler looks like this: 


on mouseUp 
go to next card 
end mouseUp 
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ns, 


This message handler is likely to be in the script of a button; it handles the message 
mouseUp. The message to which a handler responds begins with the word following 
the keyword on, which is the first word of every message handler. The entire first line, 
on mouseuUp, is a control statement: it begins with a HyperTalk keyword, it controls 
the execution of part of the script, and it is not sent as a message. When you release the 
mouse button while the Browse tool is inside a button’s rectangle on the screen, 
HyperCard sends the message mouseUp to the button. HyperCard looks in the 
button’s script for a handler matching the mouseUp message. If it finds a match, it 
runs the handler—executes the HyperTalk statements between on mouseUp and 
end mouseuUp. The second line of the handler, go to next card, is a command 
statement: it does not begin with a keyword, so it is sent as a message. 


In addition to message handlers, scripts can contain function handlers. Function 
handlers begin with the keyword. function in place of the word on and have the 
name of the function they handle following the keyword. A function handler looks like 
this: 


function day 
return the first word of the long date 
end day 


This function handler responds to a HyperTalk statement containing the function's 
name followed by parentheses—a function call: 


put day() into the message box 


When a function call is made, HyperTalk looks in the scripts of certain objects in the 
HyperCard environment for a matching function handler. If it finds one, it executes 
the lines between function day and end day. 


A script example 


The following message handlers, from the HyperCard Help stack, illustrate the basic 
syntax of a script. The first handler is in the script of the main Help stack: 


on openStack 

global HelpExit 

push recent card 

pop card into [It 

if "help" is not in It then put It into HelpExit 
end openStack 


The second handler is in the script of the background button named “Exit”: 


A script exampie 
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on mouseUp 
global HelpExit 
visual effect dissolve 
go to HelpExit 

end mouseUp 


These two handlers work together to provide an easy exit from the Help system which 
returns you to the card you were on before you entered Help. The first handler puts the 
identifier of the card you were on into a global variable; the second handler gets the 
value of that variable and takes you to the card ir identifies. 


The first and last lines of each handler are control statements. Because the first line 
begins with on, they are message handlers. The last line indicates the end of the 
handler. The first handler responds to the system message openStack that 
HyperCard sends to the currently open card as soon as its stack is opened. The second 
handler responds to the system message mouseUp that HyperCard sends to the 
*Exit” button when you click it 


The first three indented lines within the openStack handler, 


global HelpExit 
push recent card 
pop card into It 


are direct command statements; the first word of each is its command name. The 
command global declares a global variable, meaning that any handler can read its 
value (all HyperCard variables are local to their handler unless declared global); 
HelpExit is the variable name. The push recent card statement puts the 
identifier of the card you were on before you got to the current card into a last-in, first- 
out stack (an area of memory, not a HyperCard stack). The pop card into It 
statement copies that card identifier into a local variable called It. The next 
statement, 


if "help" is not in It then put It into HelpExit 


is a control statement containing a command statement That is, the first word if is 
a keyword indicating a conditional section. The if is followed by an expression that 
evaluates to true or false, and that expression is followed by the keyword then. 
The rest of the statement is a command statement. If the expression is true, the 
command is executed; if false, the command is not executed. The command put 
It into HelpExit copies the value of the local variable It into the global 
variable HelpExit. The effect of this statement is to set your exit destination to the 
card you came from only if you came from a stack whose name does not have the word 
belp in it. (The Help system has three stacks all containing beip in their names; as you 
browse among the three Help stacks, you won't destroy the original exit destination 
stored in HelpExit.) 
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The three indented lines within the second handler, 


global HelpExit 
visual effect dissolve 
go to HelpExit 


are all simple command statements. The first, global HelpExit, is the same as in 
the first handler; it ensures that both handlers refer to the same global variable. The 
next command, visual effect dissolve, sets up the transition to the next card 
you go to, So that the image of the current card will fade into the image of the next. The 
go to HelpExit command takes you back to the card you were on before you 
entered the Help system. 


HyperCard External Commands 


The HyperCard interface allows you to build extensions to the HyperTalk language 
through external commands or functions. External commands, called “ex- 
commands,” and external functions, called ‘ex-functions,” are compiled Macintosh 
resources of type 'XCMD' and 'XFCN' respectively. ECMDs and XFCNs are 
written in other high level Macintosh programming languages, such as C or Pascal. 
One of the benefits of the external command feature is that you can concentrate all of 
your programming talent on providing added functionality to HyperCard, and leave 
the building of the user interface to artists and creative designers. You can build your 
function or procedure according to the rules described later in this chapter, and then 
call the XCMD from a HyperTalk script, which you assign to any of the HyperCard 
objects. 


How HyperCard uses XCMDs 


When HyperCard cannot locate a command called in a script, as is the case with an 
external command, HyperCard looks fora resource of type 'XCMD' with the same 
name as the unknown command. Likewise, when a function cannot be found, 
HyperCard looks for a resource of type 'XFCN'. Whenever a handler (fora 
command or function) is not found in a stack script, HyperCard immediately looks for 
an XCMD or XFCN in the currently open stack. The order of the search or inheritance 
order is: 


Button (or Field) 
Card 


home XCMD 
XCMD in HyperCard application file 
HyperCard command 


HyperCard External Commands 
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An XCMD or XFCN is a code resource with no header bytes Gust like a Macintosh desk 
accessory). You can move XCMDs and XFNTs from stack to stack with ResEdit or with 


any other resource moving tool. 


Note: The procedure for moving compiled XCMDs and XFNTs is discussed in the 
HyperTalk Script Language Guide. Additionally, a utility stack, called ResCopier 
copies XCMD and XFNT resources into HyperCard stacks. The ResCopier stack is 
available from HyperCard User groups. 


The only thing passed into an XCMD or XFCN is a pointer to a XCmdBlock. It looks 
like this: 

xCmdPtr = “XCmdBlock; 

XCmdBlock = 


RECORD 

paramCount: INTEGER; { the number of arguments} 

params: ARRAY[1..16] OF Handle; { the arguments} 

returnValue: Handle; { the result of this XCMD} 

passFlag: BOOLEAN; ({ pass the message on?} 

entryPoint: ProePtr; { call back to HyperCard} 

request: INTEGER; { what you want to do} 

result: INTEGER; { the answer it gives} 

inArgs: ARRAY[{1..8] OF LongInt; { args XCMD sends HyperCard} 

outArgs: ARRAY[1..4] OF Longint; { answer HyperCard sends back} 
END; 


You read the arguments (they are handles to zero terminated strings), do whatever the 
purpose of this XCMD is, and optionally store a result into returnValue. All data values 
going to and from HyperTalk are zero-terminated ASCII strings 


Resources of type XCMD are commands, and resources of type XFCN are functions 
that return a value. If you store a result string into returnValue in a command, the user 
can get it by asking for "the result" (useful for explaining why there was an error). Ina 
function, you are expected to store the answer into retumValue. If you don't store 
anything, the result is the empty string. 7 


If passF lag is false (the normal case), this XCMD or XFCN has handled the message 
and the script resumes execution. If passFlag is true, HyperCard searches the 
remaining inheritance chain for another handler or XCMD with the same name. This 
is just like the "pass" control structure in a script 

The second part of the XCmdBlock record has to do with calling HyperCard back in 
the middle of your code to ask a question. If you wanted to manage the call to 
HyperCard yourself, you wouid fill inArgs with your arguments, put a request code in 
request, and JSR to the address in entryPoint. HyperCard returns the values you 
requested in outArgs and a result code in result. 
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Because the entire range of call back routines are packaged with HyperCard, you can 
simply call a Pascal or C procedure. The calls are documented in the HyperTalk Script 
Language Guide, available from the Apple Programmer's and Developer's 
Association (APDA). . 


Rules and limitations of building XCMDs 


Most macintosh programs are centred around an event loop. In most cases, the event 
loop is merely a large switch statement that calls the procedures that make up the body 
of your program (ie the user presses a button, pulls down a menu, etc). When the user 
takes an action, such as pressing a button, a procedure is called to handle it By using 
HyperCard's XCMDs, the buttons can be set up to call the routine directly, thus 
allowing HyperCard to handle the event looping. 


Many times it is useful to execute several commands in succession. Most users have a 
set of common procedures that they will execute in the same order again and again. 
That is why many programs have macro capability. By writing the procedures for your 
application as HyperCard XCMDs, end-users automatically have the ability to define 
macros with a user-friendly language. 


> Note: The discussion in this section applies primarily to the MPW C programming 
language. These limitations may not apply to other languages. 


Limitations of XCMDs 


Unfortunately, there is a price to be paid for all of the functionality that HyperCard 
brings. In this case, it is merely a few restrictions on programming. Because XCMDs 
are external to HyperCard, HyperCard cannot be aware of their individual data needs. 
To be more precise, XCMDs cannot use the A5 register as a pointer to their global 
data, as HyperCard uses it for it's global data space. This means that your program 
(unless it uses 2 something other than AS for it's global data) cannot have any global 
variables, nor any static variables or initializer. This also true for strings. Fortunately, 
there are several possible workarounds for these problem areas. 


No Global Variables: As mentioned ealier, XCMDs cannot access HyperCard's 
global data space for private storage. This means that all variables for an XCMD must 
be passed either as parameters or declared within a C function. Unfortunately, it is 
sometimes necessary to share information between several XCMD's. There is a trivial 
workaround. 


Workarounds for global variables: HyperCard itself can access HyperCard's Global 
data space. By using Hypercard to keep track of the information that needs to be 
shared between XCMDs, this limitation can be easily by-passed. To do this, allocate 
some space (ie call NewPtr or NewHandle) and store a pointer (Handle) to the 
space in a HyperTalk Global variable created for that purpose. 


HyperCard External Commands 
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® Note: HyperTalk globals are all stored as strings, so to store a pointer in a 
HyperTalk global, the address must be converted to a string first, and unconverted 
for later use. This also has the added advantage of allowing the you to know where 
that data is being stored in the event that you need to poke around with MacsBug or 
some other memory examining tool. 


No Static Variables / Initializers: Static Variables or initializers also use the global 
data space, so they cannot be used either. If it is necessary to use static variables, it 
may be possible to achieve the same effect by storing the data with HyperCard. There 
is no way to implement static initializers. If it is possible to Dynamically initialize your 
data, the following sections may be of use. 


No Embedded Strings: This is probably the most annoying restriction of all. As 
embedded strings (such as "Hello" in: strepy(stri,  "Hello"); ) are stored in 
the global data space they also cannot be used. There are at least three workarounds 
for this. (This is not a problem with MPW Pascal, because Pascal can handle strings.) 


The recommended workaround for the lack of embedded strings is to utilize a resource 
of type 'STR '. When a string is needed, the appropriate resource can be retrieved 
with the GetResource toolbox call. This has the added benefit of simplifying 
international conversion of the XCMDs. 


Warning: 


If you change the current resource file, you must change It back when you care 
done with that XCMD, otherwise, Hypercard may get confused. There is a 
disadvantage to using 'STR ' resources. When copying an XCMD from one 
stack to another, the 'STR ' resources must be copied aiso. At present. 
there is no standard for grouping resources together as is done with Desk 
Accessories. 


Another method for loading strings into an XCMD is to utilize an assembly-language 
file. For Example: 


stringFoo PROC EXPORT 
DC.B 'This is a string’ 
ENDP ROC 
END 


If you are using MPW C, try this method of passing strings to an XCMD: 
extern char *stringFoo; 


* Note: The order of the link is important. The C file with the code MUST come 
before the asm file with the data. This has the advantage of keeping the data with 
the code (such as, when copying XCMD's), but it is not recommended. 
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The other method for including strings is to use assignment of integer constants. A 
longword can be loaded with a character constant of up to 4 characters. As the glue 
routines expect to be handed Pascal strings, this does require some extra work (ie 
loading the length of the string into byte 0). For Example: 


{ 
char mystring[20]; 
long *tmp; 


tmp = &(mystring[1]); 
mystring(0] = (char)10; 


*tmp = 'The '; 
*(tmptl) = 'Stri'; 
*(tmp+2) = 'ng\O\0'; 
} 


This has the advantage of not requiring a separate resource, or the use of assembly to 
implement strings. It does tend to shorten the length of strings though. This also has a 
tendency to cause the MPW C compiler to generate code that will bomb on a MC68000 
based machine (such as the Mac+ and the Mac SE), and is also strongly not 
recommended. 


Building XCMDs 


The following section will take you through the development of an XCMD step by step, 
from the initial coding to the installation and debugging. The source of two sample 
XCMDs are included, along with some observations and hints along the way. 


Development Environment 


The selection of the proper development environment is very important. Currently, 
MPW is the only version of C that both has Glue and has been tested. Lightspeed C 
does have some Glue, but there appears to be some problem with the code 
generation. No matter which development system is being used, some way of moving 
resources is necessary. Resedit is a popular Macintosh resource moving utility, 
however, there are several HyperCard stacks that contain resource moving XCMDs. 
The APDA XCMD developer's kit (or an equivalent for the development environment 
that you are using) is also required, as it contains the Glue routines that are essential for 
talking to HyperCard. 
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XCMD Code 


XCMDs are pure code resources that are executing under HyperCard. HyperCard call 
the XCMD much as it would call any other subroutine. Because an XCMD is not a 
stand alone program, it must not initialize the managers, as this might cause trouble 
for HyperCard. 


Now that youhave all of the background, it is time to begin the actual coding. To make 
the following example XCMDs work, resources of type ‘STR ' must be in the Stack. 


'STR ' Resources: The following 'STR ' resources must be in the HyperCard 
Stack with the example XCMDs (you can use ResEdit to create them): 


#10 «#"PBIO" 
#2 "retv" 


#33 “iner" 


Sample XCMDs 


This first is the most simple: it merely gets the HyperTalk global variable "INCR", 
converts it to an integer, adds one to it, and puts it back into HyperCard. The second 
is an XFCN. It works the same, except it is passed a parameter, which it converts to an 
integer, increments, converts it back to a string, and places it into returnValue. The 
third executes a driver call (Kil110). This will not work unless you first write an XCMD 
to open a driver, and place a pointer to the PBIO (parameter block 1/O) struct into 
the global "PBIO". 


The first XCMD example, XPLUS1, is presented below: 


#include <types.h> 
finclude <memory.h> 
#include <resources.h> 
#include "“HyperxCmd.h" 


pascal void XPLUS1(p) 


/* 
this procedure gets a global variable “INCR"™ from 
Hypercard,increments it, and passes it back to Hypercard. 
*/ 


XCmdBlockPtr p; /* parameter passed by HyperCard */ 
{ 

unsigned longl; /* the data from HyperCard */ 
Handle 4, NewHandle(); /* The Handle to the data from/for 


HyperCard */ 


Handle S1; 


~s 


* Handle for the variable name */ 
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Sl = GetResource('STR ',33); 


H = GetGlobal(p,*S1); 


Ll = atoi(*H); 
strings 


DisposHandle(R); 
we 


de- 


H = NewHandle (30); 
stcu_dl(*8,1,30); 


SetGlobal(p,*S1,H); 
DisposHandle(H); 
ReleaseResource(S1); 


return; 
} 


f#finclude <xCmdGlue.inc.ec> 


/* 


/* 


get the variable name from rsre 
file */ 


asking AyperCard for the value in 


the variable "INCR" */ 


/* 


/* 


/* 


/* 


/* 


ALL HyperCard variables are 


converting it to a longword */ 


HyperCard creates a Handle when 
ask for a global, so we need to 


allocate it. */ 


here we act on the variable given 
in this case, we increment it. */ 


Create a new handle to pass the 
modified data back to HyperCard */ 


convert it from a long word to 
a string */ 


pass the value to HyperCard */ 
deallocate the Handle */ 
release the resource */ 


return to HyperCard */ 


Glue! */ 


The second XCMDs example, XPLUS1P is presented next. 


#include <types.h> 
#include <memory.h> 
#include "HyperxCmd.h" 
pascal void XPLUS1P(p) 


/* 


this procedure is passed a parameter by HyperCard, increments it, 


and 


places the resulting number into 


"returnValue". 
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«/ 
XCmdBlockPtr p; 


{ 
unsigned longi; 
Handle H,NewHandle(); 


H = p->params (0); 


lL = atoi(*#); 
strings 


l++; 


increment 


H = NewHandle(30); 


stcu_dl(*8,1,30); 


p->returnValue = 4H; 


return; 
} 


#include <xCmdGlue.inc.c> 


/* 


/* 
/*® 


/* 


/* 


/* 


/* 


/* 


/* 


/* 


/* 


parameter passed by HyperCard 


the data from HyperCard */ 
The Handle to the data from/for 


HyperCard */ 


get the value passed as a 
parameter to the XCMD/XFCN 


#7 


ALL HyperCard variables are 


converting it to a longword 


s/ 


here we act on the variable 


given... in this case, 


it. */ 


we 


*/ 


Create a new handle to pass the 
modified data back to HAyperCard 


convert it from a long word to 


a string */ 


pass the value to HYPERCARD 


/* note the Handle is NOT 


deallocated! */ 


return to HyperCard 


Glue */ 


The third XCMD example, KILLIO, is presented next. 


* Note: This XCMD will only work if you write an XCMD to open a driver, and place 
a pointer to it's PBIO struct in the HyperCard global "PBIO". 


#include <Devices.h> 
#include <Memory.h> 
#include <resources.h> 
f#finclude "“HyperXCmd.h" 


long atoi(); 
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*/ 


*/ 


=} 


pascal void KilllIO(paramPtr) 


XCmdBlockPtr paramPtr; 
{ 
Handle H; /* 
CntrlParam *PBCntrl; /* 
OSErr Error; /* 
unsigned long tmp; /* 
of 
Handle $1,S82; i* 
«/ 


#1 


on 


) 


Sl = GetResource('STR ',1); /* 
S2 = GetResource('STR ',2); /* 


H = GetGlobal(paramPtr,*S1); /* 


tmp = atoi(*H); /* 
PBCntrl = (CntrlParam *)tmp; /* 
DisposHandle(H); Vad 
PBCntri->ioCompletion = OL; /* 


Error = PBKil1IO(PBCntrl, false) 


/* 
H = NewHandle(20); /* 
stci_d(*H,Error,20); /* 
SetGlobal (paramPtr, *S2,H); ss 
DisposHandle(RH) ; 
ReleaseResource (Sl); /* 
ReleaseResource(S2); 
return; 


#finclude "“XCmdGlue.inc.c" 


Handle for passing values to and 
from HyperCard */ 

Control Parametre Block Ptr */ 
Possible Error Value (Gasp!) */ 
temporary variable for conversion 


ptr to the IOParam Block */ 
Handles to hold string resources 


Get the string "PBIO" */ 
Get the string "retv" */ 


Get the HyperCard Global var who's 


name is contained in 'STR ' rsre 
*/ 

these block coerces a */ 

string into a pointer to */ 
the ControlParam Block */ 

we don't need anything executed 
exit */ 


; /* the Control Call */ 


return error 


+/ 


Allocate a Handle for the 


data */ 


Convert it to a string */ 
_set the HyperCard Global */ 
/* dispose of the handle */ 
release our resources */ 


/* return */ 
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Compiling/Linking 


Once the program is written, it must be compiled and linked into a code resource. The 
easiest way to do this for a large number of XCMDs (or XCMDs using several 'c' files) is 
with a Makefile. There are 4 makefiles included here, one for each of the sample 
XCMDs, and one more for XPLUS1P as an XFCN. 


In all of the Makefiles, there is a "-m" option, followed by a string. This is the name of 
the main routine. Because we have declared the XCMD to conform to the Pascal 
calling conventions, the name of the main procedure must be capitalized, as Pascal 
converts everything to uppercase. 


XPLUS1 Makefile 


# File: XPlusl.make 

# Target: XPlusl 

# Sources: XPlusl.c XCmdGlue.ine.c 

# Created: Tuesday, December 22, 1987 11:42:57 


XPlusl.c.o f XPlusl.make XPlusl.c XCmdGlue.inc.c 
C -g XPlusl.c 

unixst2d.c.o f XPlusl.make unixst2d.c 
C -g unixst2d.c 

XPlusl ff XPlusl.make XPlusl.c.o unixst2d.c.o 
Link -sg XPlusl -m XPLUS1 @ 
“rt XCMD=3 @ 
XPlusl.c.o @ 
unixst2d.c.o @ 
"(CLibraries}"CInterface.o @ 
"(CLibraries}"StdCLib.o @ 
"(CLibraries})"CRuntime.o @ 
~o XPlusil.XCMD 


XPLUSIP XCMD Makefile 


# File: XPlus1lP .make 

# Target: XPluslP ~ 

$ Sources: XPluslP.c XCmdGlue.inc.c 
t 


Created: Tuesday, December 22, 1987 11:42:57 
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XPluslP.c.o f XPlusilP.make XPlusilP.c XCmdGlue.inc.c 


C -g XPluslP.c 


unixst2d.c.o f XPluslP.make unixst2d.c 


C -g unixst2d.c 


XPluslP ff XPluslP.make XPlusiP.c.o unixst2d.c.o 


Link -sg XPluslP -m XPLUS1P @ 
“rt XCMD=3 @ 
XPluslP.c.o @ 
unixst2d.c.o @ 
"(CLibraries}"CInterface.o @ 
"(CLibraries}"StdCLib.o @ 
"(CLibraries}"CRuntime.o @ 
-o XPluslP.XCMD 


XPLUS1P XFCN Makefile 

# File: XPluslP.make 

+ Target: XPlus1P 

# Sources: XPluslP.c xXCmdGlue.inc.c 

4 Created: Tuesday, December 22, 1987 11:42:57 


XPluslP.c.o f XPlusiP.make XPluslP.c XCmdGlue.inc.c 


C -g XPluslP.c 


‘a unixst2d.c.o f XPlusiP.make unixst2d.c 


C -g unixst2d.c 


XPluslP ff XPluslP.make XPluslP.c.o unixst2d.c.o 


Link -sg XPluslPF -m XPLUS1P 90 
“rt XFCN=3 a 
XPluslP.c.o @ 
unixst2d.c.o @ 
"(CLibraries)"CInterface.o @ 
"(CLibraries}"StdCLib.o @ 
"(CLibraries)"CRuntime.o @ 
-o XPluslP.XFCN 


KILLIO Makefile 

# File: KillIO.make 

# Target: KillIO 

# Sources: . KillIo.c 

$ Created: Tuesday, December 22, 1987 15:18:28 
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KillIO.c.o f KillIO.make KillIo.c 
C -g KillIO.c 

BCD.c.o f BCD.c 
C -g BCD.c 

unixst2d.c.o f unixst2d.c 
C -g unixst2d.c 

KillIO ff KillIO.make a 
BCD.c.o @ 
unixst2d.c.o @ 
KillIO.c.o 

Link -rt XCMD=99 -m KILLIO @ 

-sg KillIO @ 
KillIO.c.o @ 
BCD.c.o @ 
unixst2d.c.o @ 
"(CLibraries}"CInterface.o @ 
"(CLibraries}"CRuntime.o @ 
"(CLibraries}"StdCLib.o @ 
-o KillIO.XCMD 


Installing 


To Install an XCMD/XFCN into Hypercard, ResEdit or something of a similar ilk is 
required. After the XCMD/XFCN has been successfully compiled and linked, a file of 
type 'APPL' is created. This contains the XCMD/XFCN code resource. With this file, 
do the following: 


1. Open the application file with ResEdit. 


2. Open the XCMD (or XFCN) resource. If you are using the examples supplied with 
this document, there should be only one resource listed there: #3 (or number #99 for 
the KillIO XCMD). 


3. Select that resource. 

4. Copy it Cuse either the menu or -C) 

5. Open A HyperCard Stack 

6. Paste. (again, use either the menu or -V) 

7. Quit 

The XCMD/XFCN should now be installed into that HyperCard Stack. 
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Debugging 


An XCMD can be debugged much as you would any other procedure. For example, 
compile with the '-g' option to generate symbols for Macsbug. Debugger0O calls can 
be made, although DebugStr() will not work with a literal string. Under MPW C, 
DebugStr() assumes that it is being passed a Null-Terminated string, and converts 
the string to Pascal format. It doesn't convert it back. If you call cDebugStr (), this 
conversion does not take place. 


Usually it is a good idea to insert Hypertalk's "the Heapspace" calls in between XCMDs 
to insure that all handles are being de-allocated properly. If there is a rapidly 
diminishing heapspace, it may be a sign that a handle is not being disposed of 
properly. 

Another possible area for bugs to occur is with strings Hypercard treats ALL variables 
as strings, so anything that Hypercard is storing must be a null-terminated string, 
however, the glue routines all use Pascal Strings. (Be careful in string conversions!) 


Calling an XCMD From HyperCard 


There is very little that is special about calling XCMDs from Hypercard... Just call it by 
name. Parameters follow. With XFCNs, the parameter list must be enclosed in 
parenthesis. I found it best to have a handler for each XCMD, located in the stack 
script. This allowed me to ensure that the appropriate global variables were allocated 
prior to the call being made. The following examples should illustrate: 
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on doxXPlusi 
global incr,retv -- declare the global variables 
XPlusl -~ call the actual function 
put the HeapSpace into card field “HeapSpace” 
-- check to see if we are deallocating 
-- everything that is allocated. 


end doxXPlusl 


on doxXPluslP -- as an XCMD 
giobal incr,retv -- declare globals 
put returnValue of XPluslP iner into incr -~- do the command 
-~- and save the results 
put the HeapSpace into card field "“HeapSpace” “- check to see if 
~- we are deallocating everything that is 
-- allocated. 


end doxXPluslP 


on doxPlusiP -- as an XFCN 
global incr,retv -- globals 
put returnValue of XPlusipi(iner) into incr -- do the command 
-- and save the results 
put the HeapSpace into card field "HeapSpace" -- check to see if 
-- we are deallocating everything R 
-- that is allocated. 4 


end doXPlusl 


Calling the XCMD interactively 
To call an XCMD interactively, just call its handler from a button: 


on mouseUp 

global incr 

doXPiusl 

put incr into card field "foo" 
end mouseUp 


Or the call the XCMD from the HyperCard Message Box: 


doxPlusl 
put incr into card field “foo” 


The line “put iner in card field "foo"” allows changes to the variable to be 
seen after execution. 
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Calling the XCMD with Macros 


As an XCMD is just an extension to the HyperTalk language, they can be used just like 
any other feature of HyperTalk. This means that several XCMD calls can be made 
from within the same bution handler. Thus are macros added to the features of a 
HyperCard application/stack. Additionally, all af the Hypertalk control structures 
(such as repeat and if) can be used for flow control within the macro. As this is all 
done at the Hypertalk level, the C Cor whatever language that is in use) code does not 
need to be modified or recompiled. Thus an end-user who is not experienced in 
programming can create macros. One small example of the utility granted by this is 
that a macro can be written for any common task, and then can be executed with the 
touch of a single button 
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HyperCard as a data retrieval engine 


In this section we will provide an overview of two HyperCard search engine scenarios 
for CD-ROM information access. The first scenario covers designing a CD-ROM 
entirely with HyperCard and the second scenario describes working with an existing 
CD-ROM designed initially for the non-Macintosh environment. 


Designing a CD-ROM search engine with HyperCard 


Two important pieces of code need to be writen for a search engine that uses 
HyperCard stacks (referred to as stackware). The first piece of code is the inversion (or 
data analysis) engine, which you will use to build an index of your stack in an auxiliary 
table. The inversion engine is run after you have built your stack and are ready to freeze 
it, and put it on CD-ROM. To use the inversion engine you must first write a 
HyperCard script, using HyperTalk, that effectively goes through the entire stack; 
every card, every field, every word, and calls the inversion engine, which records 
every word in a the stack and where it occurs in the auxiliary table. For example, if the 
inversion engine was recording the word Apple, and found two hundred occurrences 
in the stack, it would build an auxiliary table containing word descriptor information 
like the first occurrence of Apple was on card number 2, background field 3, word 
offset 100, and so on. The data structure for the word descriptor is as follows: 


Word offset in field (<16 bits) 


When the inversion process is done, and the auxiliary table is built, it is stored along 
with the stack to be placed on the CD-ROM. Because the read-only text on the CD 
cannot be changed, the table is a static data structure. An example HyperCard script 
for building an auxiliary table from a HyperCard stack is presented below. 


function cleanName thisName 
-~strip quotes from field or bkgrnd name 
delete first char of thisName 


delete last char of thisName 
return thisName 
end cleanName 


on emit entity, cardNum, bkgndID, cardID, bkCd, fieldID, wdOffset 
~~write one word & descriptor vector to the output file 
global outFile 
put cardNum @ tab & bkgndID & tab & cardID & tab & bkCd & tab é&- 
fieldID & tab & wdOffset & tab & entity into outString 
--log to the message box for progress indicator 
put outString 
--replace linefeed with return for non-unix usage 
put linefeed after outString 
write outString to file outFile 
end emit 


function okChar theChar 

~~check to see if char type is alphanumeric 
if theChar is empty then return true 
if theChar > "/" and theChar < ":" then return true 
if theChar > "@”" and theChar < "(" then return true 
if theChar > "_" and theChar < "{" then return true 
return false 

end okChar 


function stripWord theWord 
--remove non-alphnumerics from the ends of word 
repeat while not okChar(first char of theWord) 
delete first char of theWord 
end repeat 
repeat while not okChar(last char of theWord) 
delete last char of theWord 
end repeat 
return theWord 
end stripWord 


on invert 
global outFile 
ask "Output file?" 
if it is empty then exit invert 
put it into outFile 
open file outFile 
put number of last bkgnd into lastBkgnd 
~-loop over all bkgnd types 
repeat with thisBkgnd = 1 to lastBkgnd 
go to next card of bkgnd thisBkgnd 
put the id of this bkgnd into thisIdent 
put the name of this bkgnd into thisName 
-- record bkgnd name 
if word 3 of thisName is empty then 
emit "&" & cleanName(word 2 of thisName),0,thisIdent,0,0,0,0 
end if 
put number of bkgnd fields into endField 
-- record bkgnd field names 
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repeat with thisField = 1 to endField 
put the id of bkgnd field thisField into fieldIdent 
put the name of bkgnd field thisField into fieldName 
if word 4 of fieldName is empty then 
emit "*" & cleanName(word 3 of fieldName) ,0,thisIdent,0,0,— 
fieldIdent,0 
end if 
-~ end field repeat 
end repeat 
put the id of this card into cardIdent 
put cardIdent into endident 
-- loop over all cards in bkgnd 
repeat 
put number of this card into thisNum 
-- loop over bkgnd fields in card 
repeat with thisField = 1 to endField 
put the id of bkgnd field thisField into fieldIdent 


put number of words in bkgnd field thisField into endWord 
-- loop over words in field 


repeat with thisWord = 1 to endWord 
put stripWord(word thisWord of bkgnd field thisField) into theWord 
if theWord is empty then next repeat 


emit theWord,thisNum,thisIdent,word 3 of cardIdent,0,—7 
fieldIdent,thisWord 


end repeat 
end repeat 
-- loop over card fields, if any 
put number of card fields into endcField 
repeat with thisField = 1 to endCrield 
put the id of card field thisField into fieldIdent 


put the name of card field thisField into fieldName 
-- check if named 


if word 4 of fieldName is empty then 
emit "*" & cleanName(word 3 of fieldName) ,thisNum,~- 
thisIdent,word 3 of cardIdent,1, fieldiIdent,0 

end if 

~- loop over card field words 

put number of words in card field thisField into endWord 

repeat with thisWord = 1 to endWord 
put stripWord(word thisWord of card field thisField) into theWord 
if theWord is empty then next repeat 


emit theWord,thisNum,thisIdent,thisNum,1, fieldIdent,thisWord 
end repeat 


-- end card field repeat 
end repeat 
-- end card repeat 
go to next card of bkgnd thisBkgnd 
put the id of this card into cardIdent 


if cardIdent is endIdent then exit repeat 
end repeat 
-~ end background repeat 
end repeat 
end invert 
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The second piece of code that must be written is the runtime search function. The 
search function interrogates the auxiliary tables, based on the particular set of words, 
and retrieves the desired information. This is a boolean retrieval model, which 
essentially bypasses the find mechanism of HyperCard and hands back a list of 
cards by ID which contain the words that match the search criteria. The pieces that 
make up the HyperCard CD-ROM and their interaction is shown in Figure 4-3. 


—> Png version 
Png 


Data preparation 


oe panel 
wy 


Gg ns 


A ewecwcccc co ecwan ss \ cee eee Ce Oe SOE O FOSS CES EOS SSO SSE COREE OS EEE OOESHHEBE TEASE 


Playback A > 


Stacks 
Control panel 
Interface —> a yy, 
.3 St a 
HyperCard 


Figure 4-3 
Pieces of a HyperCard based CD-ROM 


A friendly interface 


The type of ASCII search interface described above, would be far too crude to present 
to the user. However, HyperCard can be used to create a graphical interface which 
provides the user with fields and buttons that access the underlying search commands. 
For example, to present a templated search, you might build a card with an array of 
buttons and fields like those shown in Figure 4-4. 
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Figure 4-4 
Example HyperCard interface 


Working with an existing CD-ROM 


In this scenario, a library of information already exists on a CD-ROM. This CD-ROM 
has been prepared on a mainframe for use on a PC. The CD-ROM uses a PC retrieval 
engine and interface, which may include the use of familiar PC user function keys, 
mice, and windows. 


Most CD-ROM developers and information providers need to leverage the software 
investment, and write the retrieval engine in a portable language, such as; C or Pascal, 
so that it can be moved onto other operating environments. This may or may not be 
the case with the user interface portion of the code for the CD. Therefore, one of the 
big problems in the past that kept information providers from developing a Macintosh 
interface/application has been the great expense of porting the PC interface to the 
Macintosh. 
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Because the PC interface is not very portable (command lines and function keys aren't 
standard on the Macintosh), and most PC programmers are not familiar with the 
Macintosh programming environment, it may take three months or more just to 
understand how to implement the interface. This is where the HyperCard scenario, 
described below, can save you both time and money. 


“HyperCard provides a complete set of tools to compose the human interface and 
customize the retrieval model to fit the needs of your application. Engineering 
development time can be cut approximately in half by using HyperCard as a user 
interface construction kit. 


First, take the existing CD-ROM and retrieval engine and port it to the Macintosh 
operating environment. If the job is done right, there should be a clean interface 
layer consisting of function calls to the retrieval engine. After building the clean 
interface layer, you recode the function calls to have a shell around them, so that they 
look like HyperCard External Commands (XCMDs). Then you use HyperCard to build 
the graphic Macintosh interface with the proper hooks for the XCMDs. The block 
diagram in Figure 4-5, shows the steps described for this HyperCard scenario. 


Funetien calls 


Port retrieval engine 


Retrieval Function calls SF} 
ewieva 
> | engine |< 


erCard 
xemps SP 
Figure 4-5 


interface 
Preparing an existing non-Macintosh CD-ROM for the Macintosh environment 
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If mee want to work with an existing text-based CD-ROM that contains a card catalog for 
a library, you might at a aHypercard interface that includes buttons and fields like 
ow in Figure 4-6 


: ~ Te = te the titeanation ten kines 
® B O OK S FARC H ake wut Authos, Tithe oz Subject - 


Author: Sabatelll, Wayne a 


Sabbath, Steve 
Sabbatini, Charles A. 
Sackett, Richard 
Sahm, Ralph 
Sahota, Vicki 
Sakaguchi, Sandra 
heii Salaiz, Ken 


Ttems found: Shlavar rictina 
Pl Sanchez, David W. 
Sandler, Jim 


Sanford, Bill 
Santora, Gres 


Figure 4-6 
Sample card for text search 


Title: 
Subject: 


These buttons and fields provide the user with an intuitive way to supply the search 
criteria. Instead of typing in some arcane string of commands, the user would click on 
the Author, Title, or Subject field, and start to type. When the user starts typing in the 
Author field, a list of available authors would appear. The user could then select the 
author he or she wants from the list, which would then bring up a list of corresponding 
tides, as shown on Figure 4-7. 
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Author 


Number of || |A Traveler's Guide to Spain by Ken Salaiz 
items found: || | A Visitor's Guide to France by Ken Salaiz 


Ari Museums in France by Ken Salaiz 
English Country Innsby Ken Salaiz 


France on abudget by Ken Salaiz 
Quick trips to Europe by Ken Salaiz 


Figure 4-7 
Book titles corresponding to author's name 
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If the user desired more information about one of the titles, he/she should simply click 
on the corresponding name. The user would then be presented with more detailed 
information, as shown in Figure 4-8. 


Author: Ken Salaiz 
Title: A Visitor's Guide to France 


Published: — John Wiley & Sons; New York, NY: 1983 


Topics: travel 


foreign countries 


Catalog Number: |877.49 453n 


@ [of 1] 


Figure 4-8 

Detailed information in catalog card 

Once you've ported the retrieval engine and corresponding XCMD interface to the 
retrieval engine, the interface shown above is relatively easy to build with HyperCard. 
The information requested by the user is simply returned to HyperCard fields that 
correspond to the information being requested. Each field can have a unique look 
according to its properties. Fields can be shadowed, scrollable, plain rectangles, 
transparent, and opaque. Fields can contain any font that is available in the user's 
System file. 


> Note: If you plan to use fonts that are not in the standard release of the Apple 
Macintosh System file, you will have to license and supply the unique fonts with 
your product. 
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More information about fields is available in the HyperCard Script Language Guide 
and the HyperCard Owner's Guide.One of the best way to learn about the possible uses 
for HyperCard, and how it will enhance your CD-ROM product on the Macintosh, is 
hands-on experimentation. 


4-32 Chapter 4: Hypercard and CD-ROM (Alpha draft) 


Chapter 5 


Networks and 
AppleCD SC 


This chapter includes a brief overview of how to get the AppleCD SC ready for sharing 
information, and making it available to Macintosh, Apple IJ, and PC users on the 
network who have AppleShare workstation software. Installation and general 
AppleShare administrator's tasks are covered in the AppleShare Administrator's 
Guide. 


AppleCbD SC on the AppleTalk network system 


You can attach one or more AppleCD SC drives to a Macintosh working as an 
AppleShare file server on the AppleTalk network system. All Macintosh HFS, Apple I 
ProDOS, and High Sierra formatted CD-ROMs will work on the AppleTalk network as 
an AppleShare server volume. 


Naming the CD-ROM server volume 


It's a good idea to give a CD-ROM server volume a name that indicates its contents. 
For example, you may want the information for different work groups to be on separate 
volumes. You could name each volume after one of the work groups. 


Whatever name you choose, be sure that each volume name is unique. Do not use the 
same name for more than one volume. 


If only Macintosh and PC users will be accessing the CD-ROM volume, use a name up 
to 27 characters long. Do not use a colon (:) or begin with a period (.). 


If Apple II users will be accessing the CD-ROM volume, you must use a valid ProDOS 
name—up to 15 characters, including letters, numbers, and periods. You must begin 
with a letter. Do not use spaces. 


Important 


You cannot rename CD-ROMs or other locked disks. If a CD-ROM doesn’t have 
a vaild ProDOS name, Appie |i users cannot access it on the network. In 
addition, Appie Il users can open onty those folders and files with valid ProDOSs 
names. 


When using CD-ROM as a server volume, you must install AppleCD SC device driver 
on the server startup volume and on the Server Administration disk. (You also need 
the device driver on the Server Administration disk so you can access the CD-ROM 


The AppleShare server administrator can change the See Folders and See Files 
privileges for CD-ROMs (and other locked volumes) but, only for the volume, not for 
the folders on the volume. 


n 
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Chapter 6 


AppleCD SC Functional 
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CD-ROM technology—at a glance 


To understand how the AppleCD SC works, you should first understand how the CD- 
ROM media is constructed and how the data is stored on and read back from the CD- 
ROM. 


How CD-ROMs are made 


The CD-ROM is a thin plastic disc 12 cm. in diameter. Information is stored in a 
plastic-encased spiral track on one side of the disc. The spiral track consists of shallow 
depressions (pits) in a reflective layer. During the CD-ROM manufacturing process 
the binary information is encoded as pits molded into the disc, and then a reflective 
aluminum layer is applied to the embossed surface. This aluminum layer is then 
covered with a protective plastic film. The information is stored in the length of the 
pits and the distance berween them (known as land). The CD-ROM encoding scheme 
encodes binary “1” bits as the transition from pit to land or land to pit and “0” bits as 
constant pit or constant land. A cross section of the CD-ROM is shown in Figure 6-1. 


Aluminum 
layer 


Dise surface 


Laser beam ——> 


optical pick-up» [Ii iI 


Figure 6-1 
A cross-section of the CD information surface 
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How AppleCD SC reads the CD-ROM 


The spiral track on the CD-ROM is read by a noncontact optical head, which scans the 
disc radially as the disc spins above it. To retrieve the data from the CD-ROM, a low- 
power beam, from a gallium arsenide laser in the optical head, is focused through the 
transparent layer of the disc onto the spiral track and reflected back into the optical 
head. The reflected light varies depending on whether the beam is focused on land or 
ona pit. Land fully reflects light, whereas interference effects occur when the laser 
beam overlaps a pit. The photoelctronics in the optical head measure the differences 
in the reflected light intensity. The modulated-reflected light is converted to a radio- 
frequency signal by the photodetector in the optical head. The signal is sent over the 
SCSI bus to the computer and translated back into text, graphics, or sound for use in 
applications. 


About the AppleCD SC CD-ROM drive 


The AppleCD SC is a lightweight, self-contained unit that uses laser light to read digital 
and analog information recorded on the reflective surface of a CD-ROM or audio 
disc. 

The main components of the AppleCD SC include: 


O a disc drive mechanism comprising an optical pickup head, spindle motor, and 
caddy handling mechanism 


analog and digital servo electronics to maintain correct focus, tracking, and 
spindle motor speed 


digital electronics to read the recorded data and provide error correction 
a system controller 

a SCSI controller to communicate with the host computer 

analog electronics to output conventional CD-Audio stereo sound 

0 the power supply assembly 


oa 


oaada 


How these components interact is shown in the functional block diagram, Figure 6-2. 
The modules (excluding the power supply) are described following the block diagram. 
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A bieck diagram of the AppleCD SC functional modules 


The disc drive mechanism consists of a spindle servo motor, an optical pickup, and a 
cartridge handling mechanism. The servo motor rotates the CD-ROM at a variable 
speed, so that the linear speed of the focussed laser spot on the disc surface remains 
constant: the farther the track is from the center, the slower the servo speed. The 
optical pickup is a noncontact pickup that reads the disc by monitoring the focused 
laser spot reflected from the surface of the CD-ROM. 


Both the spindle and optical pickup mechanisms are controlled by the mechanism 
controller microprocessor and analog servo electronics. The radio frequency signal 
is digitized and passed to the demodulator and Cross Interleave Reed-Solomon 
Coding (CIRC) error correction electronics. The CIRC corrects most CD-ROM data 
errors in real time. The Mechanism Controller controls the mechanical assemblies: 
the focus of the laser light source, the tracking for the optical pickup, and the spindle 
motor speed. 
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The analog electronics for audio output make it possible for you to listen to CD stereo 
recordings. The analog electronics includes a digital-to-analog converter and a 
stereo audio amplifier stage to drive headphones. The analog electronics convert the 
digitally recorded audio information on the audio CD into an analog signal that is 
amplified and sent through the stereo headphone jack and the stereo jacks on the back 
of the AppleCD SC. The audio signal sent to the stereo jacks must be output through 
amplified speakers or input into an amplifier which in turn drives a separate set of 
speakers. 

The digital electronics for CD-ROM make it possible for you to retrieve data stored on 
CD-ROMs. The digital electronics processes the digital information stored on the 
CD-ROM so that your computer can read and process it. Included in the digital 
electronics is the CD-ROM layered error correction circuitry, which provides a bit 
error rate of less than 1 in 10/2 bits. This powerful error correction circuitry corrects 
any errors remaining after the CIRC stages. CD-ROM layered error correction is one 
of the key differences that separates the CD-audio players from CD-ROM drives. The 
error rates on typical CD-audio units are much higher than that of CD-ROM drives, 
because the human ear doesn’t hear minor flaws in the music. CD-ROM, on the 
otherhand, can’t have the rates of errors seen on CD-audio players passing through to 
the computer. 


The system controller processes control information received by the SCSI controller 
from the computer and routes control instructions to the various electromechanical 
modules in AppleCD SC. 


The SCSI controller provides the communication link between the AppleCD SC and 
host computer. The SCSI controller receives commands from the host and transfers 
them to the system controller. It also returns status information and data to the host 

computer from AppleCD SC. The SCSI controller has a 64K data buffer that ensures 

data throughput to the host computer is maximized. 
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Chapter 7 


AppleCD SC CD-Audio 
and Sound Production 


This chapter examines the differences between stereo CD-Audio Red Book and 
digitized sound for CD-ROM Yellow Book, and describes how to integrate sound into 
applications to enhance other CD-ROM data. It also discusses the control protocol 
that is used in the Apple Ie CD Remote to access the AppleCD SC CD-Audio features. 


CD-Audio and digitized sound for CD-ROM 


There are several differences between CD-Audio and CD-ROM sound. CD-Audio is 
the standard used to create the stereo CDs you piay on CD players. CD-Audio is said 
to produce the best sound quality of any recording medium. Using stereo sound 
interleaved with graphics and text data would be great. However, there is a serious 
drawback involved in trying to mix CD-ROM and CD-Audio tracks on the same CD- 
ROM. You can experience a loss of performance in your application. The CD-ROM 
drive not only has to seek to a different area on the disc, but also has to switch between 
CD-ROM and CD-Audio modes of operation. Switching modes can take up to one 
second, and a long seek from CD-ROM data to the requested CD-Audio track could 
take another half second. The user would hear and possibly see the change in 
application performance. 


In contrast, using sound digitized for CD-ROM could be accessed much faster, 
because the drive doesn’t have to make a mode change and the sound is stored as 
another file in the CD-ROM format. Additionally, if the sound was digitized at 
sampling rates comparable to CD-Audio sampling rates, the actual difference in the 
quality of the sound would be almost unnoticeable. (Sound sampling is described later 
in this chapter). This is not to say that CD-Audio doesn’t have uses on CD-ROM. As a 
simple example, your application could be an instructional piece on the sounds of 
musical instruments. The user could select a period in the history of music, and 
choose from a group of instruments for that period. Once the instrument was selected, 
the user might be presented a picture with some descriptive text about the selected 
instrument and hear the sound of the instrument played in true stereo CD-Audio. The 
sound would be played after the graphics and text is displayed on screen, making the 
user feel it is more of a natural transition in the program. 
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Using sound in applications 


Sound is an important piece of any multi-media application designed to work with the 
AppleCD SC. The combination of Macintosh and HyperCard provide an inexpensive 
hardware and software development environment for multi-media CD-ROM projects. 
The mixture of sound, graphics and text will certainly be the ideal way for many of the 
future training and educational CD-ROM applications to present instructional ideas 
and information. Industrial training applications might use HyperCard and sound to 
add life to training diagrams, textual instructions, and parts lists. Educational 
“HyperCard films” can be threaded through reference material, using the attractive 
power of animation and music to draw students’ attention to graphic and textual 
content, which illustrate the class curriculum. 


The following section describes methods for getting sound into the Macintosh for use 
with HyperCard multi-media applications. 


* Note: To make understanding the following sections easier, you should have a 
good working knowledge of HyperCard and the HyperTalk programming 
language. 


HyperCard and sound 


HyperCard’s HyperTalk language allows you to build tools for the integration of sound 
into Macintosh HyperCard applications. Simple HyperTalk scripting can extend 
sound clips into full length synchronized sound and graphics films. HyperCard films 
achieve a feel similar to video production, and can be played straight through or 
interactively controlled by the user. You can use HyperCard scripts to build 
presentations and training materials, create narrated tours of HyperCard databases on 
CD-ROM, or do something as creative as design talking yellow pages for a telephone 
book. More information about HyperCard and sound will be included in a future 
release of this manual. 


Accessing the AppleCD SC CD-Audio features 


One of the features of the AppieCD SC is the capability to operate in the CD-Audio 
mode (the Phillips/Sony Red Book specification). As described earlier, the CD-Audio 
mode allows you to play audio CDs on the AppleCD SC, like you would on a stereo CD 
player. However, unlike the stereo CD player, the AppleCD SC CD-Audio mode is 
only accessible through software control. initiated from a host computer This chapter 
discusses the command protocol for accessing the CD-Audio feature of the AppleCD 
SC. 
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Software written to use the AppleCD SC CD-Audio control and status calls accesses the 
AppleCD SC through the SCSI Manager and AppleCD SC device driver on the 
Macintosh and through the SCSI SmartPort interface on the Apple Ile and Apple IGS. 


@ Note: To ensure AppleCD SC application compatibility in the future, always make 
the SCSI control and status calls through the Macintosh AppleCD SC device driver 
or Apple II SmartPort, rather than going directly to the device. 


The AppleCD SC audio control and status calls are listed separately in Chapter 6, 
“AppleCD SC Software.” 


In this chapter we will use the Apple Ile CD Remote program as an example of how to 

implement CD-Audio control of the AppleCD SC. In the example only the protocol of 

the modules that actually perform the main body of the program are described. The 

bitmaps that graphically represent the remote control unit on the screen are not 

discussed. 

@ Note: You can also access the CD-Audio capability of the AppleCD SC by using 
HyperCard XCMDs to make audio calls directly through the AppleCD SC device 
driver. 


More information about the command protocol for accessing the CD-Audio feature of 
the AppleCD SC will be included in a future release of this document. 
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Chapter 8 


AppleCD SC SCSI Commands 
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AppleCD SC device specific SCSI commands 


This chapter describes the AppleCD SC device specific SCSI commands. The 
command descriptions are provided to help software developers program AppleCD 
SC device drivers for Apple and non-Apple computers. 


The Macintosh and Apple II AppleCD SC device resource software provides ail of the 
functionality most applications require, and we strongly recommend using the Apple 
device resources when working with Apple computers. 


Important 
If you attempt to create your own Macintosh or Appie ll AppieCD SC device 


resources, those resources may become incompatible with future releases of 
the Macintosh and Appie Il System software. 


The Macintosh AppleCD SC device resource command and status calls and Apple 1 
AppleCD SC SmartPort calls are described in Chapter 2, “AppleCD SC Software.” The 
Group 0, Group 1, and Group 6 AppleCD SC specific SCSI device commands are 
described below. The AppleCD SC SCSI commands are provided in an attached 
document entitled, "Apple CD-ROM SCSI Command Set,” which will be incorporated 
into this document in a future release. 


8-2 Chapter 8: AppieCD SC SCSI Commands (Alpha draft) 


R T 
(Revision 1.4, February 15, 1988.) 


The attached document is a fourth draft of the Apple CD ROM SCSI Command Set. It is a 
complete SCSI command set for the Apple CD ROM product. This command set may or may not 
be released as section 2.5 of the Apple SCSI Command Protocol specification (062-2075). If this 
command set is not released as section 2.5 of the Apple SCSI Command Protocol specification, 
then sections of that specification other than the SCSI command set are also applied to the Apple CD 
ROM product. Electrical characteristics of the Apple SCSI bus can be found in Apple specification 
062-2074. 
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2.5 C.D. ROM Commands 


Disconnect/reselect is required. If the initiator does not respond to the reselection 
within a Selection Timeout Delay(250ms), the target shall release the bus for 

200ms and then try to rearbitrate and reselect again. The target shall try the above 
disconnect/reselect procedure until the initiator responds or the target receives an 
abort or bus reset message from the reselecting initiator or a hard reset from the 
SCSI bus. The target will respond to selection from the same or other initiators 
between reselection retries. 


Disconnect/reselect is also required for audio commands. If the host chooses to use the 
disconnect/reselect feature, the drive will disconnect only for those operations that involve 


movement of the optical pickup (i.e. during seek). After the target address is found, the drive will 
play audio from that target address and reselect the host at the beginning of the audio play or audio 


scan. Since the reselection process depends on whether the SCSI bus or the host is busy, it is 
possible that the audio play or audio scan operation begins before the reselection process is 
completed. 
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2.5.1 Group 0 Commands for C.D. ROM Devices The Group 0 commands for C.D. 
ROM devices shall be as shown in Table 2.5.1-1. 
_ Table 2.5.1-1 
Group 0 Commands for C.D. ROM Devices 


Operation 
Code Type Command Name Section 

00H M TEST UNIT READY Tidak 
Oly M REZERO UNIT 8.1.1 
0277 R 
034 M REQUEST SENSE 7.1.2 
044; R 
05 R 
0677 R 
07H R 
08H M READ 12:11 
O97; R 
OAH R 
OBY M SEEK 8.1.6 
0Cy R 
OD1y R 
OEY R 
OFH R 
1047 R 
lly R 
124 M INQUIRY Td 
13 R 
14y R 
15y M MODE SELECT 12.13 
164 M RESERVE UNIT 8.1.8 
179 M RELEASE UNIT 8.1.9 

~ 18 R 
1943 R 
1AyH M MODE SENSE 12.1.4 
1B M START/STOP UNIT 8.1.11 
1Cy M RECEIVE DIAGNOSTIC RESULTS 7.1.5 
1Dy M SEND DIAGNOSTIC 7.1.6 
1EW M PREVENT/ALLOW MEDIA REMOVAL 8.1.12 
IFy R 


Key: M = Command implementation is Mandatory. 
O = Command implementation is Optional. 
R = Command code is reserved for future standardization. 


7.1.1 TEST UNIT READY Command 
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Peripheral Device Type: C.D.ROM 
Operation Code Type: Mandatory . 
Operation Code: 004 i 


The TEST UNIT READY command provides a means to determine if the C.D. ROM is powered 
up and ready for operation, and a disc is mounted. Refer to section 7.1.1 of the ANSI 
X3T9.2/82-2 Rev. 17B for details. 


8.1.1 REZERO UNIT Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: | Mandatory 
Operation Code: Oly 


Table 8-2 
REZERO UNIT Command 

“go ee dF oe | ae OP a 
Byte | | | | | | | | | 

0 | Operation Code eee ee 
ot | foaau Nees I ey Sana 
oe aga aT 
3 CE "as 
gg Ce te en Se ary 
Ce, Vendor Unique “| Reserved S”S:S”””S~SCS lang ol Linke = 


eee ewe nce e en wen ene rence rene en ean ene cnn ewe wn cen een een mn ee nnn eens ew en mnt een nn nee en nnn en wenn neonn nn re= | 


The REZERO UNIT command (Table 8-2) repositions the drive's optical pickup to the starting 
address of the disk and enters the HOLD TRACK state for the duration of inactivity time. The drive 
will spin up if it is not spinning. 


If the initiator requests disconnect, disconnect will be performed before the seek operation and 
reselect will take place following the seek operation. 


This command should not change the mode select parameters. 
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7.1.2 REQUEST SENSE Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 03H 


Extended Sense Data format is Required. 


Implementation of the additional sense code (byte 12) is required and the additional sense code of 
medium change (28H) is mandatory. 


The thirteen(13) first bytes of the Extended Format, as defined in the SCSI specifications, are to be 
supported by the target. All additional bytes are optional. 


EXTENDED SENSE DATA 
The following bytes are REQUIRED 


EESaaaoaoaoaaaaaaEaaaaaaEeeaEeeEeEeEeEeeaeaeEeEeeaeaaeEaeeeeeeeaeeeaeEaeEaeeES—ES————EEEEEE—eEEEeee 


Bit 7 6 5 4 3 2 1 0 
Byte | | | | | | | 
0 Valid | Error Class=7H | Error Code=0H 
l Segment Number=00H 
2 FM=0 EOM=0IILI=0! R | Sense Key 
3 Information Byte (MSB) 
4 Information Byte 
5 Information Byte 
6 Information Byte(LSB) 
7 Additional Sense Length (n) 
8 Optional, except for use with SEARCH and COPY (00H) 
through commands as per 7.1.4.2 (00H) 
1 1 " t (00H) 
12 Additional Sense Code 
The following bytes are optional and follow the Required Extended Sense Data 
byte 12. 
Bit 2 6 Be ho Se R.A 0 

Byte | | | | | | 

13 Reserved 

14 FRU failed 

15 FPV | CD | VU! VU! BPV | Bit Pointer 

16 Field Pointer (MSB) 

17 Ai " (LSB) 

18- N/A 

n+17 


The information bytes are not defined if the Valid (address valid) bit is zero. If this bit is one, the 
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information bytes contain the unsigned logical block address associated with the sense key. 
The FM (File Mark) and the EOM (End Of Media) bit are set to zero. 


The ILI (incorrect length indicator) bit indicates that the requested logical block length did not 
match the logical block length of the data on the medium. This bit is set to zero. 


The Sense Key codes of OH, 1H, 2H, 3H, 4H, SH, 6H and BH are required. The definition of 
the sense key code is described in Table 7-6 of the ANSI X3T9.2/82-2 Rev. 17B. 


The additional sense length specifies the number of additional sense bytes to follow. If the 
allocation length of the command descriptor block is too small to transfer all of the additional sense 
bytes, the additional sense length is not adjusted to reflect the truncation. 


Byte 12 Additional Sense code. 
The Additional Sense code O0qy indicates that the target does not support any additional sense code 


for the related Sense Key or does not have any appropriate additional sense to return for the Check 
Condition stanus that it created. 
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C.D.ROM DEVICES ADDITIONAL SENSE CODES (byte 12) 


Code Related Sense Keys 

00 No Additional Sense Information No Sense 

Ol Reserved 

02 Error occurred during seek operation. Hardware error or 
Medium error 

03 Reserved 

04 Drive Not Ready (i.e. unit off line in multiple LUN system) Not Ready 

05 Reserved 

06 Reserved 

07 Reserved 

08 Logical Unit Communication Failure Hardware error 

09 Track servo error Hardware error 


OA through OF = Reserved 


10 Reserved 
11 L-ECC uncorrectable data error (L-ECC on) Medium error 
12 through 16 ~— Reserved 
17 CIRC recovered data error (L-ECC off) Recovered error 
18 L-ECC recovered data error (L-ECC on) Recovered error 
19 Reserved 
1A Reserved 
1B Reserved 
1c Reserved 
1D Reserved 
1E Reserved 
1F Reserved 
20 Invalid Command Operation Code Tegal Request 
21 Illegal Logical Block Address Tegal Request 
22 egal function for device type Tegal Request 
23 Reserved 
24 Illegal field in CDB other than op-code or illegal logical block address 

Tliegal Request : 
25 Invalid logical unit number Tegal Request 
26 Invalid fieid in Parameter List Mlegal Request 
27 Reserved 
28 Medium changed (detected by cartridge insertion) Unit Attention 
29 Power On, Reset or Bus Device Reset occured Unit Attention’ 
2A Mode Select Parameters changed Unit Attention 
2B through 2F = Reserved 
30 Reserved Medium error 
31 Reserved 
32 Reserved 
33 through 3F = Reserved 
40 SCSI controler data buffer failure Hardware error 
41 Drive's internal bus data path failure Hardware error 
42 Power On Diagnostic Failure . Hardware error 
43 Message Reject Error (see 5.6.1.5) Hardware error or 

Aborted command 

44 ‘  _[nternal Controller Error (see 5.6.1.8) Hardware error 
45 Reselect failed (see 5.6.1.7.) Hardware error 
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46 Reserved 
~ ( 

47 SCSI Interface Parity Error (see 5.6.1.) Hardware error 

48 Initiator Detected Error (see 5.6.1.4) Hardware error or 
Aborted command 

49 Inappropriate/Illegal Message Hardware error or 
Aborted command 

4Athrough 4F Reserved 

50 through 5F _—— Reserved 

60 through 6F —- Reserved 

70 through 7F _— Reserved 

80 Prevent Medium Removal Set : Tegal Request 

81 Logical unit is reserved Tegal Request 

82 End of user area encountered on this track(only for data/audio mode change) [legal Request 

83 Overlapped commands attempted Absorted Command 

84 Tegal mode for this track (e.g. audio command for data track) Tegal Request 

85 Audio address not valid. egal Request 

86 through 9F = Vendor Unique 

AO through A6 = Vendor Unique 

A7 Vendor Unique 

A8through AF Vendor Unique 

BO No Cartridge in Drive Not Ready 

Bl Unable to recover table of contents(TOC) Not Ready 

B2 Cartridge load/eject failure Not Ready 

B3 CIRC unrecovered data error (L-ECC off) Medium Error 

BA Focus servo failure Hardware Exror 

BS Spindle servo failure Hardware Error a 

B6 Cartridge load mechanism failure Hardware Error 4 

B7 Read TOC in progress. Not Ready 


B8 through FF Vendor Unique 


Byte 14 Field Replaceable Unit (FRU) failed. A non zero value indicates failure. A value of zero 
means that no FRU is to be reported. 


Byte 15 definition: | 
-FPV (Field Pointer Value) Bit 7 of zero indicates that the target does not implement the functions | 
supported by C/D & BPV bits and bytes 16 and 17, therefore these bits and fields are not valid. Bit | 
FPV of one indicates that the Field Pointer bytes 16 and 17, the C/D and BPV bits are significant. 
-C/D bit of one indicates that the value reported in the Field Pointer is the CDB's byte number for 
which an ILLEGAL REQUEST Sense Key was issued. C/D bit of zero indicates that the value 
reported in the Field Pointer is the byte number of the DATA phase for which an ILLEGAL 
REQUEST Sense Key was issued. 

-Bits 5 and 4 are vendor unique. 

-BPV bit of zero indicates that the target does not implement this function, therefore the Bit Pointer 
field is not valid. BPV bit of one indicates that the Bit Pointer field (bits 0 through 2) is significant. 
-Bits 0 through 2, Bit Pointer, indicates which bit of the byte number reported in bytes 16 and 17 is 
the bit for which the ILLEGAL REQUEST Sense Key was issued. 


——————————— Oe 


. 
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12.1.1 READ Command 


Peripheral Device Type: C.D.ROM 
Operation Code Type: § Mandatory 
Operation Code: 08 y 


Refer to section 12.1.1 of the ANSI X3T9.2/82-2 Rev.17B for details. The drive will enter a hold 
track state at the completion of the read operation for the duration of the inactivity time. 


8.1.6 SEEK Command 


Peripheral Device Type: C.D.ROM 
Operation Code Type: Mandatory 
Operation Code: OBY 


Table 8-12 
SEEK Command 

a 7. oh es Ss he ee Pa oe oN 
Byte | | | | | l l | 
ie tree Operation Code = | 
"i tae Logical Block Address (SB) 
ce Loge Bick Adhes == =~=~=~*~*~*~S;:‘<CS~*S*S | 
i? es (ogical Block Ades SB) SSCS 
ge ee i oo 
5 Vendor Unique ae Reserved  ~—~*| -‘Filag”—=|'CLink 7 


The SEEK command (Table 8-12) requests that the logical unit seek to the specified logical address 
and enters the HOLD TRACK state for the duration of the inactivity time. 
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7.1.3 INQUIRY Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 1277 


Bytes 0 through 53 of the Inquiry data are Required. Bytes 54 through the end of 
the data are optional. 


INQUIRY DATA 
Bit 7 6 5 4 3 2 1 
| | | | | | | | 
BYTEO Peripheral Device Type (05H) 
BYTE 1 RMB=1 | Device Type Qualifier (00H) 
BYTE2 ISO Version ECMaA Version | ANSI Version=1H 
BYTE 3 Reserved | Response Data Format=1H 
Response Data Format: — 
Description 

OH Vendor Unique 

ly Common Command Set (CCS) 

24 through Fry Reserved 


Targets conforming to at least conformance level 2 as defined in Table E1, Appendix E, of the 
standard, and conforming to this document shall set the Common Command Set code (1,4) in 


the Response Data Format field. 


BYTE 4 Additional Length (n) 
BYTE 5 Vendor Unique 

BYTE 6 and7 Reserved 

BYTE 8 Vendor Identification (in ASCID 
through "Vendor Name' 

BYTE 15 

BYTE 16 Product Identification (in ASCIT) 
through ‘CD-ROM 'space Unique model number assigned for Apple’ 
BYTE 31 

BYTE 32 Revision Level (in ASCID) 
through ‘Firmware revision level’ 

BYTE 35 

BYTE 36 Vendor Unique 

through (Command Bit Map, see explanation below) 
BYTE 55 

BYTE 56 Reserved 

through 

BYTE 97 

BYTE 98 Vendor Unique 

through 

XX 
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Beginning at byte 36 in the VENDOR UNIQUE area of the response are 

extension bytes ta.specify the number of extents supported by the RESERVE (command $16) and 
RELEASE (command $17) commands. Following this is a list of SCSI commands supported by 
this device. Commands map into this list by their group code and command code values. Values 
are returned by first specifying a Group Code Specifier (a byte for the Group Code value; 0 for 
Goup 0, 1 for Group 1, etc), then specifying a 4 byte Command Bit Map representing the 
commands implemented within that group. The bit map is constructed by setting a bit for an 
implemented command according to that command's value, and clearing a bit otherwise. Bits 
within the bit map are numbered in ascending order beginning with the first bit following the Group 
Code Specifier. This list is terminated by specifing a $FF for the Group Code (no additional 
command bit map bytes are necessary). 


Example: The following is an example of the format. 


Byte 36:00 (Hi Order byte - number of Extents] 

Byte 37:$00 (Low Order byte -number of Extents] 
Byte 38:300 {Group 0 commands} 

Byte 39:$D0 [Commands 0H,1H,3H] 

Byte 40:$90 (Commands 8H,BH] 

Byte 41:$27 [Commands 12H,15H,16H,17H] 

Byte 42:$3E 

[Commands 1AH,1BH,1CH,1DH,1EH} 

Byte 43:$01 [Group 01 commands] 

Byte 44:304 [Command 25H] 

Byte 45:391 [Commands 28H,2BH,2FH] 

Byte 46:$00 (No commands implemented in this range] 
Byte 47:318 {Commands 3BH,3CH] 

Byte 48:306 {Group 6 commands] 

Byte 49:$FO0 

[Commands COH,C1H,C2H,C3H] 

Byte 50:$FC {Commands C8H to CDH] 

Byte 51:300 [No commands implemented in this range] 
Byte 52:300 {No commands implemented in this range] 


Byte 53:3FF [End of list] 
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8.1.7 MODE SELECT Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 1I5y 
Table 8-13 
MODE SELECT Command 
,——__________.___________ a aEEEEEEIEEEREEEEREEEEREEREEREEERIERREEEEREes 

Bit! 7 | 6 8 1 4 FS 3 [ 2 } 4 | 0 | 
Byte | | | | | | | | | 
0 | Operation Code — | 
gases |-enennnnnnne ween een mewn enn nnn nnemennmnennnnannnanmenanenanannncnnacnaasmunenae| 
Ly Logical Unit Number | Reserved | SP=0 | 
— | ------- = nnn nn nn nnn nn nnn nnn nn nnn nnn nnn nn nnn nnn nnn nnn nena nn nnn nena nn| 
2) Reserved | 
on----- enna nnn nnn nnn nn nnn nnn nnn nnn nnn nnn nnn ns an nn nnn nn nn err enn nn nnn nnn neennnnnne| 
3 | Reserved | 
meen [ona - nn nnn nnn nn nn nn nnn ene een nnn en nnn nnn an nen n nee enn n nen en nne wenn neem ennnee | 
4 | Parameter List Length | 
—_—-—- enn nnn n= nn nnn nn nnn nn nnn nnn nnn anne nn nnn a en nnn nnn meen enn mn nnn nnn nnn nnnnnnn+| 
5 | Vendor Unique | Reserved | Flag | Link | 


Mandatory Page Codes for Mode Select and Mode Sense 


1. Page Code $0: Unit Attention 

2. Page Code $1: Error Recovery Parameters 

3. Page Code $2: Disconnect/Reconnect Control Parameters 
4. Page Code $20: Drive Parameters. 

5. Page Code $3F: Report Values (Mode Sense only) 


The MODE SELECT command (Table 8-13) provides a means for the initiator to specify or 


change medium, logical unit, target or peripheral device parameters to the target. This 
command is Required within the Apple Common Command Set. 


The Parameter List Length specifies the length in bytes of the MODE SELECT parameter list that 


shall be transferred during the DATA OUT phase. A parameter list length of zero indicates that no 
data shall be transferred. This condition shall not be considered an error. 
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The MODE SELECT parameter list (TABLE 8-14) contains a four-byte header, followed by zero or 
one block descriptor, followed by zero or more Pages. 


Table 8-14 
Mode Select Parameter List 
“Rie a tit te SO a oh ee ee a eG 
Byte | | | l | l | | | 
0 | Reserved a et 
re ees mnie 
oe ae eas aaa 
> enna Block Descriptor Length (OH or 08H) 
Block Descriptor(s) 
| Reserved oie ie | 
is a aes Number ofBlocks (SB) OH 
eat ee en Numberof Blocks OHS 
aber of Blocks SB) OH 
eye eee Sed wt ner arse ea fi 
ores Suxkiaghossy 
eo ee oe cao 
<a es ee: 
Page Descripror(s) 
Gi Rak | Page Code es 

is ann CPT owas aaa 
at ee ee ea re ee 


esa Vea eag  iee e ia r Oaleeeacdaca| 


The Medium Type is set to 00H for C.D. ROM 


The Block Descriptor Length specifies the length in bytes of all the block descriptors. A block 
descriptor length of zero indicates that no block descriptors shall be included in the parameter list. 
This condition shall not be considered an error. The number of blocks field specifies the number of 
logical blocks on the medium that meet the block length in the Block Descriptor. A 00H in all 

the Number of Blocks fields specifies all the logical blocks of the logical unit. 
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Optional additional blocks of parameters called Pages may be sent to the target in 
the Data Out phase of the MODE SELECT command, following either: 

- the MODE SELECT Header, if the Block Descriptor length is set to zero. 

- or one Block Descriptor. 

The Block Descriptor Length shall not include the length of the Pages. 


Page Definition: 

Each defined Page is preceded by a Header of two bytes defining the Page Code 
and the length of the page. Following the Header, the Pages are separated into 
sub-blocks containing a list of related flags and/or values. 


Bits 7 and 6 of byte 0 are reserved. 


The Page Code identifies the meaning of the following bytes in the Page. The 
Page Code is either defined, reserved or vendor unique. The parameters in the 
defined Pages are classified in priority sequence to ease implementation by the 
target. 


The Page Length value of each defined page, shall not include the Page Length 
byte. The Page Length represents the number of bytes that the target supports in 
each Page. The target may return in the Pages of the MODE SENSE commands as 
many consecutive bytes that it supports, for each Page that it supports, without 
splitting fields of multiple bytes. The Page Length shall be set in the pages of the 
MODE SELECT commands to the exact same value (zero value included) returned 
by the target in the MODE SENSE Page Length bytes. Otherwise, the target shall 
create Check Condition status with the Sense Key of ILLEGAL REQUEST. 

The initiator shall issue a MODE SENSE command requesting the target to return 
all Changeable values (see PCF field configuration 01B in byte 2 of the MODE 
SENSE CDB) prior to issuing any MODE SELECT commands, in order to find out 
which Pages are implemented by the target and the length of each Page for that 
particular LUN(Logical Unit Number). 


Initiator Implementor Notes: : 

- Those Pages, supported by the target, in which the initiator requests parameters 
to be changed shall be sent to the target. . 
- The initiator may send in MODE SELECT commands all Pages supported by the 
target. 

- The Pages are not required to be sent in ascending order. 


In the event of a Hard Reset, the target shall first attempt to restore the Default 
Parameters. 
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i Unit Attention 
ly Error Recovery parameters 
2H Disconnect/Reconnect Control parameters 
3y through Fy Reserved 
204 Drive Parameters. 
21y-2F y, 31q-3Eq Vendor Unique Page formats 
3FH Defined in MODE SENSE only. 


The initiator may issue a MODE SELECT command at any time. 


The target may or may not save the block descriptors and Pages for each LUN and 
for each initiator. If the target supports 8 LUNs and the bus configuration 
includes 7 hosts, the target would have to save 56 sets of MODE SELECT/ MODE 
SENSE data. The data for each LUN for each host could be different. 
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ERROR RECOVERY PARAMETERS. Page code 14. 


———— eee eee ee ee 
Se SS 


Bit 7 6 5 4 3 2 1 0 
Byte | | | | | | | 
0 R | R |  PageCode=lp 
1 Page Length (in bytes) 
2 R I! R | TB ! RC | EEC ! PER | DTE |! DCR 
3 Retry Count 
4 servi 
2 Reserved 
6 Reserved 
7 Recovery Time Limit = 00H 


NOTE: In the event of a conflict between the bit definitions and the error recovery procedures 
defined on pages 19 and 20, the error recovery procedures take precedence. 


A DCR (Disable Correction) bit 0 set to one indicates that the data shall be transferred without 
applying error correction (layered ECC). A DCR bit set to zero enables error correction 
(layered ECC). iti : 


A DTE (Disable Transfer on Error) bit 1 set to one and if the PER bit is set to one, indicates 
that the target shall create the Check Condition status and terminate the data transfer to the initiator 
immediately upon detection of an error. The Transfer Length is then not exhausted. The data of the 
block in error, which is the first erring block encountered, may or may not be transferred to the 
initiator depending upon the setting of the TB bit. The DTE bit can only be set to one by the 
initiator if the PER bit is set to one. The target shall create the Check Condition status with Illegal 
Request Sense Key, if it receives PER bit of zero and DTE bit set to one. 

A DTE bit set to zero enables data transfer for any data which can be recovered within the limits of 
the Error Recovery Flags. Any erring block that would be posted, which is the last recovered block 
encountered, is not posted until the Transfer Length is exhausted. 


A PER (Post Error) bit 2 set to one indicates that the target shall enable the reporting of the 
Check Condition status for recovered errors, with the appropriate Sense Key. The Check 
Condition shail happen during the data transfer depending either on the DTE bit value or if an 
unrecoverable error occured. If multiple errors occur, the REQUEST SENSE data shall report the 
block address of either the last block on which recovered error occured or of the first unrecoverable 


error. 
A PER bit set to zero indicates that the target shall not create the Check Condition status for errors 
recovered within the limits established by the other Error Recovery Flags. Recovery procedures 
exceeding the limits established by the other Error Recovery Flags shall be posted accordingly by 
the target. The transfer of data may terminate prior to exhausting the Transfer Length depending on 
the error and the state of the other Error Recovery Flags. 


The PER bit is default t 


An EEC (Enable Early Correction) bit 3 set to one indicates that the target shall enable the use 
of the most expedient form of error recovery, such as error correction, before applying retries. 

Seek or positioning retries and the recovery procedure retries of the message system are not affected 
by the value of this bit. Targets implementing error correction schemes that do not provide the most 
expedient form of error recovery should default to zero and report the EEC bit as not changeable in 
the MODE SENSE Page code 3. EEC and DCR both of one is an invalid request, for which the 
target shall create the Check Condition status with egal Request Sense Key. 
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An EEC bit set to zero, indicates that the target shall exhaust the defined retry limit prior to enabling 
error correction. If DCR bit is set to one, the defined retry limit only is to be performed. 


The ECC bit is default t 


A RC (Read Continuous) bit 4 set to one requests the target to transfer the entire requested 
length of data without adding delays that would increase or ensure data integrity (ie. delays caused 
by the target's error recovery schemes). This implies that the target may send data which may be 
erroneous or fabricated in order to maintain a continuous flow of data and avoid delays. 

The target shall assign priority to this bit over conflicting error control bits (EEC, DCR, DTE, PER) 
within this byte. 

A RC bit set to zero, indicates that error recovery operations which cause reasonable delays are 
acceptable during the data transfer. Data shall not be fabricated. 


A TB(Transfer Block) bit 5 set to one indicates that the failing data block (recovered or 
unrecoverable) data shall be transferred to the initiator. A TB bit set to zero indicates that the failing 
data block (recovered or unrecoverable) data shall not be transferred to the initiator. 

Implementor Note: In both cases, but particularly when TB is zero, the block address reported in 
the REQUEST SENSE data shall be of the erring block, not of the preceding block. 


The TB bit is defaul 


The following table summarizes all valid modes of operation. 


Value Error Recovery Byte Bit Settings 


oe re ee ee et ee ce ere re re eres, 
eS SS a eS TS 


| Reserved |Reserved| TB I|Reseved | EEC | PER | DTE |! DCR | 
| | | 


00. | | Oo | | 0 | 0 | 0 | 
on: |. / ol «0 tf 01 0 1 1 4% 
Mot he Oe Oe ed Oe | 
is te a ee ee eae a ee 
06 gis AO ate ee se CO 
7! 0 h6Ul ok be ed ot 
ol he a Oe ek 
i. hk a ee eh Oe 
eo a et Oe eh 
eo ee i oe a ee ee re 
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The following are the definitions of the errors reported by the C.D. ROM. 


1) CIRC recovered data error: This error is defined as a data block for which the C2 flag was set, ( 
buton a subsequent read retry operations it was not set. The number of the subsequent read 
operations is limited to the read retry count (Byte 3 of the error recovery parameters page). 

L-ECC is not used in this case. 


2) CIRC unrecovered data error: This error is defined as a data block for which the C2 flag was set 
on all read operation up to the read retry count. L-ECC is not used in this case. 


3) L-ECC recovered data error: This error is defined as a data block for which C2 are asserted but 
the layered ECC was able to correct the error within the read retry count. 


4) L-ECC uncorrectable data error: This error is defined as a data block which could not be 
corrected by the layered ECC within the read retry count. 


Recovery Time Limit is the maximum time that the target shall aren. error recovery actions to 
recover data. A zero value indicates that the time is unlimited. 
QOH for C.D, ROM. 
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This.is the default value of the error recovery byte. L-ECC ison. Only L-ECC 
unesrectabie Sala SerOcs ate TepOrIeS. fae ee me error occurs, data 


ste) en 4 

block with a CHECK ‘CONDITION status. The caine key is eet to MEDIUM 
ERROR and the additional sense code is set to L-ECC UNCORRECTABLE 
DATA ERROR. The information bytes in the REQUEST SENSE command are 


* set to the address of the first encountered uncorrectable block address. 


04H 


26H 


20H 


Apple Computer 


- L:ECC recovered data block errors are reported. If an L-ECC 


recovered data error Occurs, 


data blocks (including the L-ECC recovered data block) are transferred to the 
initiator. After the data transfer is completed, a CHECK CONDITION status is 
reported. The sense key is set to RECOVERED ERROR and the additional 
sense code is set to L-ECC RECOVERED DATA ERROR. The information 
bytes are set to the address of the last block for which an L-ECC recovered data 
error was detected. If an L-ECC uncorrectable data error occurs, data transfer is 
not terminated until all requested data blocks (including the L-ECC uncorrectable 
data block) are transferred to the initiator. After the data transfer is completed, a 
CHECK CONDITION status is reported. The sense key is set to MEDIUM 
ERROR and the additional sense code is set to L-ECC UNCORRECTABLE 
ERROR. The information bytes are set to the address of the last block for which 
an L-ECC uncorrectable error was detected. 


L-ECCison. L:ECC recovered data errors are reported. If a L-ECC recovered 


data error occurs, 

encountered L-ECC recovered data block with a CHECK CONDITION status. 
The sense key is set to RECOVERED ERROR and the additional sense code is 
set to L-ECC RECOVERED DATA ERROR. The information bytes are set to 
the address of the first encountered L-ECC recovered error block. If an L-ECC 
uncorrectable data error occurs, data transfer is terminated at the beginning of the 
first encountered L-ECC uncorrectabie data block with a CHECK CONDITION 
status. The sense key is set to MEDIUM ERROR and the additional sense code 
is set to LLECC UNCORRECTABLE ERROR. The information bytes are set to 
the address of the first encountered L-ECC uncorrectable block. 


CHECK CONDITION status. 


L:-ECCison. Only L-ECC uncorrected data error are reported. If an L-ECC 
uncorrectable data block error Occurs, i j j 


transferred to the initiator. After the data transfer has completed, a CHECK 
CONDITION status is reported. The sense key is set to MEDIUM ERROR and 
tha additional sense code is set to L-ECC UNCORRECTABLE ERROR. The 
information bytes are set to the address of the last block for which an L-ECC 
uncorrectable data error was detected. 
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01H 


27H 


21H 


Error recovery procedures for the C.D. ROM Mode 1 and Mode 2 data block, 


_— 


L-ECC is not used. vi . Ifan 
CIRC unrecovered data error occurs, i j inning 
of the first encountered CIRC unrecovered data block with a CHECK 
CONDITION status. The sense key is set to MEDIUM ERROR and the 
additional sense code is set to CIRC UNRECOVERED DATA ERROR. The 
information bytes are set to the address of the first encountered CIRC 
unrecovered block address. 


If an CIRC 


L-ECC is not used. 
aah ele data block error tie 


to the initiator. After the dita pansteri is re a CHECK CONDITION 
status is reported. The sense key is set to RECOVERED ERROR and the 
additional sense code is set to CIRC RECOVERED DATA ERROR. The 
information bytes are set to the address of the last block for which an CIRC 
recovered data error was detected. If a CIRC unrecoverable data error occurs, 
data transfer is not terminated until all requested data blocks (including the CIRC 
unrecovered data block) are transferred to the initiator. The sense key is set to 
MEDIUM ERROR and the additional sense code is set to CIRC 
UNRECOVERED DATA ERROR. The information bytes are set to the address 
of the last encountered CIRC unrecovered block. 


L-ECC is notused. CIRC recovered data errors are reported. Ifa ¥ ECC 
recovered data error cyaaletatn 
with a CHECK CONDITION 


status. The sense key is set = RECOVERED ERROR and the additional sense 
code is set to CIRC RECOVERED DATA ERROR. The information bytes are 
set to the address of the first encountered CIRC recovered error block. If an 
CIRC unrecovered data error occurs, data transfer is terminated at the beginning 
of the first encountered CIRC unrecovered data block with a CHECK 
CONDITION status. The sense key is set to MEDIUM ERROR and the 
additional sense code is set to CIRC UNRECOVERED ERROR. The 
information bytes are set to the address of the first encountered CIRC 
unrecovered block. 


CONDITION status. 


L-ECC is not used. 
CIRC unrecovered data block error ein 


transferred 10 the initiator. After the data pom has completed, : a CHECK 
CONDITION status is reported. The sense key is set to MEDIUM ERROR and 
tha additional sense code is set to CIRC UNRECOVERED ERROR. The 
information bytes are set to the address of the last block for which an CIRC 
unrecovered data error was detected. 
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DISCONNECT/RECONNECT CONTROL PARAMETERS. Page code 247 


LS Se AS SD SS S-DSRS SSE SEY NESSES EEG CUERD em wir ev 
SS LN ae Seay See 


Bit 7 6 5 4 3 Zz 1 0 


rg err ree ne ner 
SS SS Se Sas Seay Senate Seer ee ae 


Page Code = 247 
Page ear a ee) 
Buffer Full 
Reserved 
Bus Inactivity Limit (MSB) 
Bus Inactivity Limit (LSB) 
Disconnect Time Limit (€MSB) 
Disconnect Time Limit (LSB) 
Connect Time Limit (MSB) 
Connect Time Limit (LSB) 
0 Reserved 
1 Reserved 


=e OCO~TINMARPWNH © 


Each ratio parameter is the numerator of a fractional multiplier that has 256 as its 
denominator. 


Buffer Full Ratio indicates to the target, on READ commands, how full the buffer shall be prior 
to reconnecting. 


The default value of the Buffer Full Ratio is 08H. 
The relationship between the values of the buffer full ratio and the number of blocks are specified 


below. 

Value Number of Number of Value Number of Number of 
of Buffer 2048 2336/2340 of Buffer 2048 aa 
OOH. , 5 28 

01H - 08H 1 1 81H - 88H 17 15 
09H - 10H Z Z 89H - 90H 18 16 
11H - 18H 5 3 91H - 98H 19 17 
19H - 20H 4 4 99H - AOH 20 18 
21H - 28H 5 5 AlH - A8H 24 19 
29H - 30H 6 6 A9H - BOH 22 20 
31H - 38H 7 7 B1H - B8H 23 21 
39H - 40H 8 8 B9H - COH 24 21 
41H - 48H 9 8 C1H - C8H 25 22 
49H - 50H 10 9 C9H - DOH 26 23 
51H - 58H 11 10 DiH - D8H 27 24 
59H - 60H 12 11 D9H - EOH 28 25 
61H - 68H 13 12 E1H - E8H 29 26 
69H - 70H 14 14 E9H - FOH 30 27 
71H - 78H 15 14 F1H - F8H 31 28 
79H - 80H 16 15 FOH - FFH 32 28 

Apple Computer Inc. Confidential Page 21 


February 15, 1988. Apple CD ROM SCSI Command Set 062-2097 Revision 1.4 


Bus Inactivity Limit field (bytes 4 and 5) indicates the maximum time in 100 microseconds 
increments that thé target is allowed to maintain the bus busy without handshakes until it shall 
disconnect. The target may round to its nearest capable value. A setting value of zero indicates that 
- the target is allowed to maintain the bus busy indefinitely without handshakes until it determines to 
disconnect. The default value for the Bus Inactivity Limit field is 00H. 


Disconnect Time Limit field (bytes 6 and 7) indicates the minimum time in 100 microseconds 
increments that the target should remain disconnected until it attempts to reconnect. The target may 
round to its nearest capable value. A setting value of zero indicates that the target is allowed to 
reconnect immediately. The default value for Disconnect Time Limit field is 00H. 


Connect Time Limit field (bytes 8 and 9) indicates the maximum time in 100 microseconds 
increments that the target should remain connected until it attempts to disconnect. The target may 
round to its nearest capable value. A setting value of zero indicates that the target is allowed to 
remain connected indefinitely until it determines to attempt disconnection. The default value for 
Connect Time Limit field is 00H. 
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DRIVE PARAMETERS. Page code 20}. 


~ Bt 7 6 5 4 3 yn ca a 
Byte | | | | ] | | | 
=e RB R | Page Code=203¢C=*é<“‘< <;2(~2~XR#R”*‘;~™*” 
1 Page Length (in bytes) = 02H 
2 Rsvd. | Rsvd. | Rsvd. | Rsvd. | Rsvd. | Rsvd | Rsvd | Rsvd 
3 Reserved | Inactivity Time-Out 


The Inactivity Time-Out byte is used by the initiator to set the time-out value to 
spin-down the medium and turn off the laser when the drive is inactive (for both 
data and audio operation). The drive will remain in the hold track state after 
completion of a seek or read operation during the inactivity time-out period. The 
time-out value is the value of this 4-bit field times 2 minutes. A 0H in this field 
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8.1.8 RESERVE UNIT Command 


Peripheral Device Type: C.D. ROM ( 
ion Code Type: Mandatory 
Operation Code: 16,4 


Table 8-15 
RESERVE UNIT Commands 
Bi 2 6 iS oh a ES PP oe PP OP 
Byte | | | | | | | | 
0 | Operation Code ic 
as togalaisaue °F ede fed pen ei ae 
Se gee eee ea rg 
Bg er a a ee ee ar ee 
tN eae rere ore eee Rear ey egos 
os eer ee ee Bae oh an a 


RESERVE UNIT Command. The RESERVE UNIT command (Table 8-15) is used to reserve 

the specified logical unit for the exclusive use by the requesting initiator or, if the third-party ( 
reservation is requested, to another specified SCSI device. The implementation of the EXTENT bit 

is not required. 


The reservation shall remain in effect until superceded by another RESERVE UNIT command from 
the initiator that made the reservation or uintil released by a RELEASE UNIT command from the 
same initiator, ora BUS DEVICE RESET message from any initiator, or a "hard" RESET 
condition. The occurance of the last two conditions is indicated by a sense key of UNIT 
ATTENTION on the next command following the condition. It is not an error to issue this 
command to a logical unit that is currently reserved to the requesting initiator. 


If the logical unit is previously reserved by another initiator, then the target shall return a 
RESERVATION CONFLICT status. 


If, after honoring the reservation, any other initiator then subsequently attempts to perform any 
command on the reserved logical unit other than a RESERVE UNIT command, or a RELEASE 
UNIT command(which shall be ignored), then the command shall be rejected with a 
RESERVATION CONFLICT status. 


The third-party reservation for the RESERVE UNIT command allows an initiator to reserve a 
logical unit for another SCSI device(initiator). This is intended for use in multiple-initiator systems. 


If the third-party (3rdParty) bit is zero, then third-party reservation is not requested. If the 3rdParty 

bit is one, then the RESERVE UNIT command shall reserve the specified C.D. ROM unit for the 

SCSI device specified in the third-party device ID field. The target shall preserve the reservation 

until superceded by another RESERVE UNIT command from the initiator that made the reservation ( a 
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or until released by the same inidator, bya BUS DEVICE RESET message from any initiator, or by 


a "hard" RESET eondition. The target shall ignore (i.e., return GOOD status) any attempt made by 
any other initiator to release the reservation. 


An initiator that holds a current reservation may modify that reservation (e.g., switch third-parties) 
by issuing another RESERVE UNIT command to the same logical unit (C.D. ROM). The 
superceding RESERVE UNIT command shall release the previous reservation state only when the 
new reservation is granted. 
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8.1.9 RELEASE UNIT Command. 


Peripheral Device Type: C.D. ROM ( 
Operation Code Type: Mandatory 
Operation Code: 174 
Table 8-17 


RELEASE UNIT Commands 


7 cs a ee Oe oe |” ee, 
Byte | | | | | | | 

0 | Operation Code maa: 
ea ase URE Nusa “Men Geb Ci Recocal 
ee ee Reserved 4 
a an ecaceaicaaaaala ee en 
ry Rete ee Oe eG are 
“é. I Vendor Unique a hanes ee ee 


oe eee SSS SSS 


The RELEASE UNIT Command (Table 8-17) is used to release the logical unit if it is currently ( 
reserved by the requesting initiator. 


It is not an error to attempt to release a logical unit that is not currently reserved to the requesting 
initiator. However, it shall not be released if it is reserved by another initiator. 


The third-party release for the RELEASE UNIT command allows an initiator to release a logical unit 
that was previously reserved using the third-party reservation option (see 8.1.8). 


If the third-party (3rdParty) bit is zero then the third-party release option is not requested. If the 
third-party bit is one, then the target shall release the specified logical unit, but only if the 
reservation was made using third-party reservation by the initiator that is requesting the release and 
for the same SCSI device as specified in the third-party device ID field. 
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8.1.10 MODE SENSE Command 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: LAW 
Table 8-18 
MODE SENSE Command 

Bit! 7 | 6 a) | 4 | 3 | 2 | | 0 
Byte | | | | | | | | 
a ne Operation Code ee a 
Sates [Sse ee acre mete elem ee a | 
1 | Logical Unit Number | Reserved | 
wwnenee |--na newman nnn nnn nena nnn nnn ea nen nnn enn renner nnn nnnmn nen enema nn nn nnn nnn nanan nnnnenenennnen==-| 
2 PCF Page Code | 
“== |nmnn nnn nnn men mn ne nn nnn nnn en nn nnn nn ene eee renee nen ne enn nn ene nnn nnn | 
a: Reserved | 
oe | aman a nnn nn nnn ee nnn anne en rennet nn nn enn nnn nn nen emn nn nnne| 
4 | Allocation Length | 
wernmne [omen nnn nnnnnn nen nnn nnn nnn enna nnn neem enn en nen enn nnn nen nnn nnnnen en en en en enone en nnn nn nnn ene | 
5 | VU Reserved | Flag | Link | 


The MODE SENSE command (Table 8-18) provides a means for a target to report its medium, 
logical unit, or peripheral device parameters to the initiator. It is a complementary command to the 
MODE SELECT command (see 8.1.7). 


The PCF (Page Control Field) bits 7 and 6 of byte 2 defines the type of Page 
Parameter values to be returned. 


BC7)B(6) 
00 Current Values 
01 Changeable Values 
10 Default Values 
Ld Default Values 


Current Values 
The current values returned are either the parameters set in the last sucessful MODE SELECT 
command or the default values if a MODE SELECT command has not been executed. 


Changeable Values 

The pages requested will be returned with the bits that are allowed to be changed set to one. 
Parameters that are not changeable will be set to zero. I f any part of a field is changeable, all bits in 
that field are set to one. 

The page descriptor as defined in this document will always be returned even if none of the 
parameters are changeable within the page. 
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Default Values, 
Pages requested will be returned to the initiator with the fields or bits set to the default values. ( 
Fields and bits not supported by the target shall be set to zero. 


The Page Code bits 5 through 0 of byte 2 indicates which Page(s) to return. If the 
page code is 3FH, all implemented pages are requested to be returned by the 
target. 


Page Codes (bits 0 through 5 of byte 2) 


Fase Code Meaning _ 

H Unit Attention 

ly Error Recovery parameters 

2H Disconnect/Reconnect Control parameters 
20H Drive Parameters 

3Fy Return all Pages to the initiator. 


The allocation length specifies the number of bytes that the initiator has allocated for returned 
MODE SENSE data. An allocation length of zero indicates that no MODE SENSE data shall be 
transferred. This condition shall not be considered as an error. Any other value indicates the 
maximum number of bytes that shall be transferred. The target shall terminate the DATA IN phase 
when allocation length bytes have been transferred or when all available MODE SENSE data have 
been transferred to the initiator, whichever is less. 


The MODE SENSE data (Table 8-19) contains a four-byte header, followed by one eight-byte block 
descriptors, followed by zero or more Pages. 


r 
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_ . Table 8-19 

MODE SENSE Data 
a oF | 6 Se 4 a Ok ae ee eo 
Byte | | | | | | | | | 
0 | — Cond °° og 
oe MiuutypOH = 7 
Se ee eee 
age es ns ibibespeiackeo 

Block Descriptor(s) 

Oo} Reserved Rec ag 
roots 88) 
zo Number of Blocks | 
nn 
4 | Reserved | 
rng 0688) 
6 | Block Length 
2c is "1 
Page Descriptors) 

“0 | PSO | R | _. Page Code pore ee teoot 
apie ta ene ease. 
oe Refer Page definiuon in MODE SELECT. 


The Sense Data Length byte specifies the length in bytes of the following MODE SENSE data that 
is available to be transferred during the DATA IN phase. The Sense Data Length byte shall not 
include itself. If the Allocation Length of the CDB is too small to transfer all the 

sense data, the Sense Data Length shall not be adjusted to reflect the truncation. 


Medium T hould be 00H for C.D, ROM di 
WP (Write P ted) bit i i for. C.D. ROM 
The block descriptor length specifies the length in bytes of one block descriptor, therefore this field 
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should be set to 08H. 
The number of blocks field specifies the number of logical blocks on the medium that meet the 


block length in th® Block Descriptor. 

all the logical blocks of the logical unit. The Block Length specifies the length in 
bytes of each logical blocks, Block Length of 256(100H), 512(200E), 
1024(400H), 2048(800H), 2052(804H, ontional), 2336(920H) .2340(924H), or 
2352(930H, optional) bytes are supported by the target. The default block length 
is. 2048 bytes. 


Pages are returned following zero or one block descriptor if requested. Each page has a header 
defining the page code and the page length. Following the header are page parameters. The page - 
length value is the number of bytes that follow the page length sta and does not include the 
header. The pages are defined under the MODE SELECT command. 


The initiator shall issue a MODE SENSE command requesting the target to return all Changeable 
values (PCF field configuration 01B and Page Code 3FH in byte 2 of the MODE SENSE CDB) 
prior to issuing any MODE SELECT commands, in order to find out which Pages are implemented 
by the target and the length of each Pages for that particular target. 


An initiator may request a particular Page to be returned by the target by selecting its code in byte 2 
of the CDB. 


8.1.11 START/STOP UNIT Command. 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code 1B 
Table 8-20 


START/STOP UNIT Command 


ie le Sd a OU Sk Oe 
Byte | | | | | | | | | 
71. ~S—~CO””*«Cpermtion CodetCi“‘S!SC*~‘S™SC‘*d 
T7 7 Lopical Unit Namber ee eyo ee wen age rage 
ae aa aaa 
a Reserved oe on nn ee ra Tp 
SR rarer pee eo owt eee ae 
“5 i Veen | 4 OReened --~~O!:*SC«C lag), ine i 
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The START/STOP UNIT Command (Table 8-20) requests that the target enable or disable the 
logical unit for further operation. 


An immediate (Immed) bit of one indicates that the status shall be returned as soon as the operation 
is initiated. An Immed bit of zero indicates that status shall be returned after the operations. If the 
Immediate bit is zero and the initiator Supports disconnect/reconnect, the command will disconnect 
while performing the command. 


A start bit of one requests the logical unit be made ready for use (i.e. the drive will spun up and the 
laser beam, focus servo and tracking servo are put into on state). A start bit of zero requests that the 
logical unit be stopped (Le. the drive will spun down and the laser beam, focus servo and tracking 
servo are put into off state). 
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7.1.5 RECEIVE DIAGNOSTIC RESULTS Command. 
iph vice Type: C.D.R ( 
Operation Code Type: Mandatory 
Operation Code: 1Cy 
Table 7-18 


RECEIVE DIAGNOSTIC RESULTS Command 


bh 9?) Oe eS a a a 
Byte | | | | | | | | 

0 | Operation Code ~~ | 
eae [Login UntNumber | ti<‘i‘s‘*@S aa ee 
ee ng ae gn ene oe ee 
es eee! ea aaa 
gape Ge 
5 i Veruae i eee ee Tithe 


The RECEIVE DIAGNOSTIC RESULTS Command (Table 7-18) requests analysis data be sent to 
the initiator after completion of a SEND DIAGNOSTIC command. ( 


The allocation length shall specify the number of bytes that the initiator has allocated for returned 
diagnostic data. An allocation length of zero indicates that no diagnostic data shall be transferred. 
Any other value indicates the maximum number of bytes that shall be tranferred. The target 
terminates the DATA IN phase when allocation length bytes have been transferred or when all 
available diagnostic data have been transferred to the initiator, whichever is less. 
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The RECEIVE DIAGNOSTIC data contains an eight-byte parameter list defined as follows. 


Table 7-18-1 
Receive Diagnostic Data 


Ber 9 of 6 os aa OB a a ee og 
Byte | | | | | l | | | 

0 | Reserved eet SG 
i eae maacianGH. oo ey 
Pas te eee ee aD 
Pagar a te ee ny RAMDugnsic 
a ee ice mies 
io Gees be 
ee eee 
<2 Ree eg 


The parameter length specifies the length in bytes of the following Receive Diagnostic parameters. 
The parameter length does not include itself. Since there are six bytes following the parameter 
length byte, the parameter length byte is set to 06H. 


If bit 0 of the ROM Diagnostic field is set to one, it indicates that the controller ROM has failed. If 
the bit 1 of the ROM Diagnostic field is set to one, it indicates that the drive control ROM has failed. 


If bit 0 of the RAM Diagnostic field is set to one, it indicates that the controller RAM has failed. If 
the bit 1 of the RAM Diagnostic field is set to one, it indicates that the drive control RAM has failed. 


If bit 0 of the Data Buffer Diagnostic field is set to one, it indicates that the controller data buffer has 
failed. If the bit 1 of the Data Buffer Diagnostic field is set to one, it indicates that the drive control 
data buffer has failed. If the bit 2 of the Data Buffer Diagnostic field is set to one, it indicates that 
the drive control error RAM has failed. 


If the bit 0 of the Interface Diagnostic field is set to one, it indicates that the controller/drive control 


interface has failed. If the bit 1 of the Interface Diagnostic field is set to one, it indicates that the 
drive control /mechanism control interface has failed. 
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7.1.6 SEND DIAGNOSTIC Command. 


Peripheral Device Type: C.D. ROM ( 
Operation Code Type: Mandatory 
Operation Code: 1Dy 
Table 7-19 
SEND DIAGNOSTIC Command 

pt 7 eS RO ee 
Byte | | | | l | | | | 

0 | Operation Code vee ii 
onne--- [amen enn nnn nn nnn nnn nn nn nn rn nnn nnn nnn nnn nn nen me nnn nnn nnn nnn nnn nnn n nnn nn ne | 

1 | Logical Unit Number | Reserved | SelfTest | Reserved | 
eae ee mn lee een itr ceanee-nen ne ee scene Meee meen OO eee 

2-4 Reserved | 
Randares Fe ta a ee a nee 

3 | Parameter List Length (MSB) | 
wn nee [ean nnn nnn na nn nnn in nan nn nn an nnn nn nnn nnn ne | 

4 | Parameter Liat Length (LSB) | 
sen nnn [penn nnn nn a nnn a nn nn nn nn nnn enn een ne | 

5 | Vendor Unique | Reserved | Flag | Link | 


The SEND DIAGNOSTIC Command (Table 7-19) requests the controller to perform diagnostic . 
tests on itself, on the attached periperal devices, or both. Except when the self-test bit is one , this ( 
command is usually followed by a RECEIVE DIAGNOSTIC RESULTS command. 


A SelfTest bit of one directs the controller to complete its default self-test. If the self-test is 
requested, the parameter list length shall be set to zero. If the self-test bit is set to one and the 
parameter list length is not zero, the command will be terminated with a CHECK CONDITION 
status. The sense key is set to ILLEGAL REQUEST and the additional sense code set to INVALID 
FIELD IN CDB. The controller may not disconnect during self-test . 


If the self-test does not fail, the command will be terminated with a GOOD status; otherwise, the 
command will be terminated with a CHECK CONDITION status and the sense key will be set to 
HARDWARE ERROR. 


The parameter list length specifies the length in bytes of the parameter list that will be transferred 
during the DATA OUT phase. A parameter list length of zero indicates that no data will be 
transferred. This condition will not be considered as an error. 


If the self-test is not requested the controller will return GOOD status upon receiving a valid 
command descriptor block and parameter list. The parameter list length is set to eight if user 


ifed diagnostics are requested. The results of the diagnostic test are returned to the initiator by a 
RECIEVE DIAGNOSTIC RESULTS command. 


The send diagnostic data in the DATA QUT phase is vendor unique. The following is an 
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The SEND DIAGNOSTIC data contains an eight-byte parameter list defined as follows. 


_ Table 7-19-1 
Send Diagnostic Data 
eo ee a ae ee oo a a Pe 
Byte | | | | | | | | | 
=a? eee Se ee 
i a ae Sag SSS a ca laa 
i aaa ia fifo. ee 
a. a ii ico 
Sete nn ee Set er en 


The parameter length specifies the length in bytes of the following Send Diagnostic parameters. 
The parameter length does not include itself. Since there are six bytes following the parameter 
length byte, the parameter length byte should be set to 06H. 


Bit 0 and bit 1 of the ROM Diagnostic field are used for checking the controller ROM and the drive 
control(CDC) ROM respectively. Bit 2 to bit 7 of the ROM Diagnostic field should be set to 0. 


Bit 0 and bit 1 of the RAM Diagnostic field are used for checking the controller RAM and the drive 
control(CDC) RAM respectively. Bit 2 to bit 7 of the RAM Diagnostic field should be set to 0. 


Bit 0 ,bit 1 and bit 2 of the Data Buffer Diagnostic field are used for checking the controller data 
buffer , the drive control(CDC) data buffer and the drive control(CDC) error RAM respectively. 
Bit 3 to bit 7 of the Data Buffer Diagnostic field should be set to 0. 


Bit 0 and bit 1 of the Interface Diagnostic field is used for checking the controller/drive control (i.e. 


controller to CDC)interface and the drive control/mechanism (i.e. CDC to CDD) interface 
respectively. Bit 2 to bit 7 of the Interface Diagnostic field should be set to 0. 
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8.1.12 PREVENT/ALLOW MEDIA REMOVAL Command. 


PeripheratDevice Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 1EyW 


This command requests that the target enable/disable the removal of the cartridge in the drive. A 
prevent bit of one will inhibit the removal of the cartridge by using the eject disk command or by 
use of the eject button. The emergency pin hole eject mechanism will not be overridden. If the 
initiator issues EJECT DISK command with the PREVENT bit of this command set to one, the 
EJECT DISK command will have CHECK CONDITION status with the sense key of illegal 
request and the additioal sense code of 80H (vendor unique) for prevent media removal. Prevention 
of the cartridge removal condition will be terminated upon receipt of a BUS DEVICE RESET 
message or a hard reset. Refer to section 8.1.12 of ANSI X3T9.2/82-2 Rev. 17B for details. 
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2.5.2 Group 1 Commands for C.D. ROM Devices The Group 1 commands for C.D. 
ROM devices shall be as shown in Table 2.5.2-1. 
Table 2.5.2-1 
Group 1 Commands for C.D. ROM Devices 


ere eae TEE SS TS AS SS SSD A APES SS STEN _ 
eS aaa SSS a cr ce ce a a Sn eS a Sa eS Se a ST eT 


READ CAPACITY 8.2.1 


READ EXTENDED 12.2.1 


SEEK EXTENDED 8.2.4 


12.2.4 


WRITE BUFFER CCS(X3T9.2/85-52) 
READ BUFFER CCS(X3T9.2/85-52) 


Fy 
IT 
PHASED DDWDHDADDDADDSHDDEDDEDDSA DDD D 
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Key: M = Command implementation is Mandatory 
E = Command implementation is Required for SCSI devices that support device independent 
self-configuring software. e 
O = Command implementation is Optional. ( 
R = Command code is reserved for future standardization. 
V = Command code is available for Apple unique commands. 


8.2.1 READ CAPACITY Command. 


Peripheral Device Type: C.D.ROM 
Operation Code Type: § Mandatory 
Operation Code: 25,7 


The READ CAPACITY command requests that the target controller determine the physical size of 
the currently mounted C.D. ROM disc. 


The logical block address bytes, PMI (partial medium indicator) bit and RelAdr (relative address) bit 
are set to zero in this command. 


The target sends eight bytes to the initiator during the data transfer phase. The first four bytes is the 
logical block address of the last valid logical block address on the medium. The second four bytes 

is the block length in bytes of the logical block on this disc. The logical block address and the block 
length are based on the value of the block length set in the Mode Select parameter. The block length 

is default to 2048 bytes. Refer to section 8.2.1 of ANSI X3T9.2/82-2 for details. ( 


12.2.1 READ EXTENDED Command 
Peripheral Device Type: C.D. ROM 


Operation Code Type: | Mandatory 
Operation Code: 28,4 


After the read the optical pickup is ina HOLD TRACK state for the duration of the inactivity 
time-out. Refer to section 12.2.1 of ANSI X3T9.2/82.2 Rev. 17B for details. 


8.2.4 SEEK EXTENDED Command 
Peripheral Device Type: C.D.ROM 


Operation Code Type: | Mandatory 
Operation Code: 2Byy 


After the seek the optical pickup is in a HOLD TRACK state for the duration of the inactivity 
time-out. Refer to section 8.2.4 of ANSI X3T9.2/82.2 Rev. 17B for details. 
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12.2.4 VERIFY Command. 


Peripheral Device Type: C.D.ROM 
Operation Code Type: | Mandatory 
Operation Code: 2Fyy 


Table 12-12 
VERIFY Command 
ree Ge i 6. ok Se A a ee a oe 
Byte | | | ] | | ] | | 
a eee, Cpr, Cat Sore! 
i ct Leo a ee Ns DR a Ls en Tse cm oe 
Oe Te ee re as nd sicsisricaskass ck hres : 
cd OREN Rene Since sasnearche OE eR 
ic eee RE kc eecakiasge eee 
sel fe tee ee Oe eee Oe ete 
6 | Reserved | 
Sala a 
is een: Ceca ae 
9 : Vendor Unique | Reserved | Flag | Link | 


rere ere mere nee 


The VERIFY command (Table 12-12) requests that the target verify the data on the medium based 
on the error recovery parameters setting. This command provides a mean to verify the medium 
without transfering data through the SCSI bus. ‘ 


The BIkVfy (blank verify) bit and the RelAdr (relative address) bit are set to zero. 


should be set to 2048 or 2336 bytes in the mode select command. 
byte-by-byte compare of the data on the medium and the data transferred from the initiator. 
Implementation of the byte-by-byte compare (BytChk=1) is not required for C.D. ROM. 


The logical block address specifies the logical block at which the verification operation shall begin. 


The verification length specifies the number of contiguous logical blocks of data that shall be 

vertified. A verification length of zero indicates that no logical blocks shall be verified. This 

condition shall not be considered as an error. Any other value indicates the number of logical 
blocks that shall be verified. 
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2.5.2.1 WRITE BUFFER Command. 


Peripheral Device Type: C.D. ROM ( 
Operation Code Type: Mandatory 
Operation Code: 3BH 
Table 2.5.2.1-1 
WRITE BUFFER Command 
Be ee ee A a oe OE ee 
Byte | | | | | | | | | | 
0 |! Operation Code ee | 
Ti eauaNaee oN Reeve 
Se ee Pare re 
a ra een 
gg ee See en ee On ee ee a 
“Spe ose 
Fg eee 
i ee Tous eagh; (dew bag catecdetyeny |, 
io; aaeaces imusrlengh@sbyey =~=~=*~O*~S~S~SCSCS 
~9) a “T Link 7 


The WRITE BUFFER command (Table 2.5.2.1-1) is used in conjunction with the READ BUFFER 
command as a diagnostic function for testing the target's buffer memory and the SCSI bus integrity. 
There shall be no access to the medium during the execution of this command. 


Data to be transferred is preceded by a four-byte header. The four-byte header consists of all 
reserved bytes as shown in the following diagram. The WRITE BUFFER header is sent as part of 
the data transfer phase to the controller. The purpose is to make the READ BUFFER transfers 
equivalent in byte count. 
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- Write Buffer Header 
ee 6 Ss ae eee ds or 
Byte | | | | | | | | | 
iQ: Rye) ee 
“i ees as neg 
st fe ie ere ay 
os as: ae ee ere, 


The function of this command and the meaning of fields within the command descriptor block 
depend on the contents of the mode field. 


Mode Field L et 
0OB Combined header and data with buffer offset set to zero. 
01B Combined header and data with the buffer offset specifies the byte 
offset within the buffer where the data will be stored. 
10B Reserved. 
11B Reserved. 


The buffer offset is the byte offset within the buffer where the data will be stored. If the controller 
is unable to accept the specified buffer offset, it will return CHECK CONDITION status and it will 
set the sense key to ILLEGAL REQUEST. If the mode field is set to OOB and the buffer offset field 
is set to nonzero value, the drive will return Check Condition. 


The transfer length specifies the maxium number of bytes that will be transferred during the DATA 

UT phase. This number includes four bytes of header, so the data length to be stored in the 
target's buffer is transfer length minus four. The initiator should attempt to ensure that the transfer 
length is not greater than four plus the available length that is returned in the header of the READ 
-BUFFER command. If the transfer length exceeds the available length plus four, the controller will 
return CHECK CONDITION status and will set the sense key to ILLEGAL REQUEST. If the 
buffer offset plus the transfer length is greater than 64K+4, the drive will generate a Check 
Condition. 
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2.5.2.2 READ BUFFER Command. 


Peripheral Device Type: C.D. ROM 
Operation Code Type: Mandatory 
Operation Code: 3Cy 
Table 2.5.2.2-1 
READ BUFFER Command 

Bt ere he a ey a Se ee a eo 
Byte | | | l l | | | | 
0 | Operation Code i eas: 
"a EogeaaeNunbe eae ee 
27 es etre Shr eee Eee ee Ee 
Maye Buffer offset(MS bye) SSS 
Ree a ee eg eer anne at tee 
ss ! oe Buffer offset (L.S. art ee neers 
as ! a Alloca tion Length (MLS. ee 
is A ee a rere ae 
se or ee 
9 Venue ae vd. lag fe 


The READ BUFFER command (Table 2.5.2.2-1) is used in conjunction with the WRITE BUFFER 
command as a diagnostic function for testing the target's buffer memory and the SCSI bus integrity. 
There shall be no access to the medium during the execution of this command. 


A four-byte header followed by data bytes are retumed to the initiator during the DATA IN phase. 
The read buffer header is defined below. 


Read Buffer Header 
oe: ke Se a ee OP Oa oe 
Byte | | | | | | | ! 
0 | Reserved = ty 
a Minnis oC 
aris Available Length Open eye 
“ea: co  erediishe 


The available length specifies the total number of data bytes that are available in the target's data 
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buffer. The number is not reduced to reflect the allocation length nor is it reduced to reflect the 
actual number of bytes written using the WRITE BUFFER command. Following the READ 
BUFFER header, "the target shall transfer data from its data buffer. The number of data bytes 
transferred following the READ BUFFER header shall be the lesser of allocation length minus four 
or available length. The buffer offset field plus the available length field is always equal to 64K. 


The function of this command and the meaning of fields within the command descriptor block 
depend on the contents of the mode field. 


Mode Field Description 
00B Combined header and data with buffer offset set to zero. 
01B Combined header and data with the buffer offset specifies the byte 
offset within the buffer where the data will be read. 
10B Reserved. 
11B Reserved. 


The buffer offset is the byte offset within the buffer where the data will be read. If the controller is 
unable to accept the specified buffer offset, it will retum CHECK CONDITION status and it will set 
the sense key to ILLEGAL REQUEST. If the mode field is set to OOB and the buffer offset field is 
set to nonzero value, the drive will return Check Condition. 


The allocation length specifies the maxium number of bytes that the initiator has allocated for 
returned header and data. An allocation length of zero indicates that no header or data shall be 
transferred. Any other value indicates the maximum number of bytes that shall be transferred. The 
target terminates the DATA IN phase when allocation length bytes of header plus data have been 
transferred or when all available header and data have been transferred to the initiator, whichever is 
less. 
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2.5.3 Group 6 Commands for CD-Rom Devices The Group 6 commands for CD-Rom 
devices shall be as shown in Table 2.5.3-1. 


Table 2.5.3-1 
Group 6 Commands for CD-Rom Devices 


So A ce 


tion 

srasern Type Command Name Section 
COW M EJECT DISC 2.5.31 
Cly M READ TOC 25.3.2 
C2y M READ Q SUBCODE 2:5:3:3 
C3y M READ HEADER 2.5.3.4 
C4y R 
C5 R 
CoH R 
C7 R 
C8y M AUDIO TRACK SEARCH 2535 
Con M AUDIO PLAY 25.3.6 
CAH M _ AUDIO PAUSE 25,554 
CB M AUDIO STOP 2.5.3:8 
CCH M AUDIO STATUS 2.5.3.9 
CDH M AUDIO SCAN 2023540 
CEH R 
CF R 


Key: M = Command implementation is Mandatory 
E = Command implementation is Required for SCSI devices that support device independent 
self-configuring software. 
O = Command implementation is Optional. 
R = Command code is reserved for future standardization. 
V = Command code is available for vendor unique commands. 
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2.5.3.1 EJECT DISC Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: COy 


Table 2.5.3.1-1-6 
EJECT DISC Command 

a 7 eS OR OR Se Oe ae Oe oe 
Bye | | | | | | | | 

0 Operation Code Spare es 
"i. eau 1° °° fee Ne 
oe ee aI ec es RIE en nt ee Oe Pace | 

2 | Reserved | 
ae ees ne og ep ee 
ie ee ee sy ee nr err rig 
‘ap ag ree, 
Tepe ee me ee aaa aa SOE 
qe ey oe 
a a = aaa a 
9 | — Reserved | + ©Reservedstsid [Fag | Link 1 


The EJECT DISC command (Table 2.5.3.1-1) specifies for the CD-Rom to eject the disc cartridge. 


¢ IMMED BIT: Function specifies when status of EJECT DISC is returned. 
IMMED BIT = 0: After completion of command execution, CD-ROM returns status. 
IMMED BIT = 1: Before completion, immediately, CD-ROM returns status. 
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2.5.3.2 READ TOC Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: C1ly 


Table 2.5.3.2-1 
READ TOC Command 

ae Gee es (ea - S  e  e ee 
Byte | | | | 

0 | Operation Code - 

| 
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11 Logical Unit Number Reserved 
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2 Reserved 


gi & 
if 
3 
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aeceeoe 
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a : Allocation Length (M.S. byte) 
| AllocationLength(LS.byt) 
9 | TYPE | Reserved | Flag! Link | 


This command transfers TOC (Table of contents) data from the CD disc to the initiator. 


¢ Track Number(TNO) specifies the starting track number in BCD for the cases when the 
TYPE=10B. The starting track ranges from 01 to 99 in BCD. The TNO byte is reserved for 
TYPE=00B, 01B or 11B. 


-| 


| 


When specifying the track number larger than the last TNO or when specifying the track number 


smaller than the first TNO, the check condition status is returned. 


The allocation length specifies the number of bytes that the initiator has allocated for returned 
data. An allocation length of zero indicates that no data will be transferred. Any other value 
indicates the maximum number of bytes that will be transferred. The target terminates the 
DATA IN phase when allocation length bytes have been transferred or when all available data 
has been transferred to the initiator, whichever is less. 
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: 


Description ; 

00B _ Transfers the first and last user track number in BCD. 

01B Transfers the starting address of the Lead out area in BCD MIN-SEC-FRAME 
format. 

10B Transfers the starting address of each track for a range of tracks starting from the 
track specified in the TNO byte in ascending sequential order until the number of 
bytes specified in the allocation length have been transferred or when all available data 
has been transferred to the initiator, whichever is less. 

11B __ Reserved. 


Gi) TYPE =00B 
This format transfers the first and last user track number in BCD. 


Table 2.5.3.2-2 Read TOC Data (TYPE = 00B) 


Bil 7 | 6 |! 5 lt # | 3 1 2 4 4 | oOo | 
Byte | | | | | | | | 
Ey RH Se ce Sn Ree EIN PRT SIGUE CRO ea AREER EDN ae 

0 The first user track number (TNO) in BCD | 


(ii) TYPE =01B 
This format transfers the starting address of the Lead out area in BCD MIN-SEC-FRAME format. 
Table 2.5.3.2-3 Read TOC Data (TYPE=01B) 
Bil 7 | 6 I 5 | 4 JF} 3 $F 2 4 1 +t 0 


0 | Lead-out area starting address in BCD (MIN) | 
<i, « ee Eo. 
“> ea hres adiress inBCD FRAME) SSS 
eck ene aa a ES 
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SS SS eee Eee eee eee 
eee eee eee eee ee aa SS ee 


(iii) TYPE = 10B 


This format transfers the starting address information (i.e. control field, MIN, SEC and FRAME) 
of each track for a range of tracks starting from the track specified in the TNO byte in ascending 
sequential order until the number of bytes specified in the allocation length have been transferred or 
when all available data has been transferred to the initiator, whichever is less. 


Table 2.5.3.2-4 Read TOC Data (TYPE=10B) 


——————<——— Serrnaresnetrenspete gece 


i ee er ee ee ee ee ee ee ee ee ee 
Bye l | ] ] l | | 
OL Reserved — | Control field of a specified mack | 
“TT;  garting pole Ofaspecined tk GMINGGBCD). = 
Ty [ning point of a specified wack (SECinBCD) SSS 
Ty ing point fa specified wack @RAMEinBCD) 


The above four-byte starting address information is repeated for each track in a range of tracks. 
(iv) TYPE = 11B: Reserved. 


The following is tt LTOC ft lisk cl =" 
addition the drive should not read the TOC again after a hard reset from the SCSI 
bus. 


1) CD ROM drive returns the Check Condition status when any command is sent from the host 
during the TOC read. 


2) CD ROM drive returns a sense key "Not Ready" and an additional sense code of B7(Read TOC 
in progress) when host does Request Sense after check condition as stated in item 1 above. 


3) If the drive is unable to read the TOC in the maximum interval allowed by the Yellow Book, 
then the drive gives a check condition followed by a sense key of "Not Ready” and an additional 
sense code "Unable to recover TOC” (B1). 


4) The Read TOC command will not force the drive to reattempt to read the TOC unless there has 
been a disc change or a power up. 
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2.5.3.3 READ Q SUBCODE Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: C2 


Table 2.5.3.3-1 
READ Q SUBCODE Command 

a oT hh 6 aS re eS ee 
Byte | | | l | | | 

0 | Operation Code Ts 
ad . Teena (ee eg 
Pt ee eer Pa 
Sagas eee ep ee ene 
aa aE ae 
Sa aa aaa 
a re ee age eer 
Fae tee emcee eS ge ne 
cy 
Raa ea ee Ne 0c RR Pan 


This command (Table 2.5.3.3-1) transfer the current Q SUBCODE ADDRESS loaded from either 
audio or data track to the initiator. 


When the CD-Rom is not in READY state, a check condition is returned. 


The allocation length specifies the number of bytes thar the initiator has allocated for returned data. 
An allocation length of zero indicates that no data will be transferred. Any other value indicates the 
maximum number of bytes that will be transferred. The target terminates the DATA IN phase when 
allocation length bytes have been transferred or when all available data has been transferred to the 
initiator, whichever is less. 
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Table 2.5.3.3-2 Format of Q SUBCODE data. 
ca ee ae a es ee ee es a 
Bye | | | | | | | | 

0 | Reserved | ConmolField = ==StSt~=«~*S 
a a 
21 CD SUBCODE Q ADDRESS data (X) | 
“TT  SUBCODE O ADDRESS Gm GIN) 
a 
5 | CD SUBCODE Q ADDRESS data (FRAME) | 
OE  SUBCODE 0 ADDRESS data (AMIN) aaa 
ia: [on SUBCODE O ADDRESS dam (ASE) 
Ty [" SUBCODE O ADDRESS data (AFRAME) ae a 


————— eee 


The Control Field is defined as follows. 


BIT | Content | 
| 3 [> sae ib’ Ik -< 0 | | 
1 oO ! O | xX J 0 | 2 Audio Channels WITHOUT Pre-Emphasis 

| 0 1 oO t xX I 1 | 2 Audio Channels WITH Pre-Emphasis 

f 1 1 o | xX | 0 | 4 Audio Channels WITHOUT Pre-Emphasis 

1 1 ; oO | xX | 1 | 4 Audio Channels WITH Pre-Emphasis 

| 0 | 1 J xX | 0 | Data Track 

; oO ¢ 2 | XK I 1 | Reserved 

| 1 | 1 | X It X | Reserved 

1 KX |! KX t| O tt X | Digital Copy Prohibited 

| KX | X 1 1 7 X 

| I | 


| Digital Copy Permitted 
| 


erence sant 


The track number specifies the current track number in BCD notation. The value of this has a 
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range of 01 to 99. 

The Index Number(X) specifies the index number in the current track. 

oo SEC and FRAME fields specifies the relative running time from the beginning of the 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. 


2.5.3.4 READ HEADER Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: C3y 
Table 2.5.3.4-1 
READ HEADER Command 
orn GO 
By | l | | | | 
0 | Operation Code ae 
a> teeters. A eee : 
OD Teal Block Address (MSE) SSS | 
Pa ns ge Te le | 
Sg pe ern oe we age Pe a ae | 
Sn ne ee Gee | 
sa aaa al a aaa 
Pa reer a > agate ae | 
age OE rg Fo eg ane eee : 
x Reserved | Reserved | Fag | Lmk 


This command returns four bytes of header information of the specified logical block address. This 
command is similar to the READ EXTENDED command, but only the header bytes are returned to 
the initiator. 

System or application program can find out the mode of the block more easily with this command. 
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If the logical block address is within an audio track, a CHECK CONDITION will be reported in the 
status phase. = 


The allocation length specifies the number of bytes that the initiator has allocated for returned data. 
An allocation length of zero indicates that no data will be transferred. Any other value indicates the 
maximum number of bytes that will be transferred. The target terminates the DATA IN phase when 
allocation length bytes have been transferred or when all available data has been transferred to the 
initiator, whichever is less. 
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i: Table 2.5.3.4-2 HEADER DATA q 
Bil) oe Me as oa Se ee a 
Byte | | | | | l | | 
0 | "absolute time (A MIN) oe i 
pat et ote ete Ce 
2 ro ea. 
“FZ ae 
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2.5.3.5 AUDIO TRACK SEARCH Command 
Peripheral Device Type: CD-Rom 


Operation Code Type: Mandatory 
Operation Code: C87 


Table 2.5.3.5-1 
AUDIO TRACK SEARCH Command 


Bitl 7 | 6 4 | 4 fe ~s3 | 2 oe | | 0 
Bye | i | | | 

0 ; Operation Code a 
ie ites I Pay ee 
ea a 

2 Search Address | 
Sa aaa a) 
i - 

6 | Reserved | 
i an eg er 
i SS aaa 
“9 [et | Reserved i(i‘its*™ "Fag | Link | 


The AUDIO TRACK SEARCH command (Table 2.5.3.5-1) provides a means for positioning the 
optical pickup at address specified by the Search Address parameter. This command returns the 
status byte when the requested search address is found. If the search address is not found, or if the 
drive is not ready, or if the search address is not within an audio track, a CHECK CONDITION 
status will be returned. 


A PLAY bit of zero indicates the drive will enter the hold track state (i.e. pause) when the search 
address is found. The music will then be played back when a AUDIO PLAY command is issued. 
A PLAY bit of one indicates the drive will output the audio channels in the specified Play Mode 
when the audio address is found. 


The drive can accept and perform another command which will or will not terminate the current 
audio play operation as described in the underlined section under the AUDIO PAUSE command 
description. 

PLA Y-MODE (Byte 01, bits 3 to 0) specifies the play mode as follows: 
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(i) © PLAY-MODE = 0000B: Play with MUTING on. 

(ii) PLAY-MODE =0001B: Play R-channel only thru R-channel only. 
(in) PLAY-MODE = 0010B: Play L-channe] thru R-channel only. 

(iv) PLAY-MODE =0011B: Play L/R channels thru R-channel only. 

(v) |PLAY-MODE = 0100B: Play R-Channel thru L-channel only. 

(vi) PLAY-MODE =0101B: Play R-chan thru L, R-chan to R-chan. 

(vii) PLAY-MODE =0110B: Play R thru L, L thru R. 

(viii) PLAY-MODE =0111B: Play R thru L, L/R thru R. 

(ix) PLAY-MODE = 1000B: Play L channel thru L-channel only. 

(x) PLAY-MODE = 1001B: Play L-channel thru L, R thru R, STEREO. 
(xi) PLA Y-MODE = 1010B: Play L-chan thru L, L-chan to R-chan. 

(xii) PLAY-MODE = 1011B: Play L thru L, L/R thru R-channel. 

(xiii) PLAY-MODE = 1100B: Play L/R thru L-channel. 

(xiv) PLAY-MODE = 1101B: Play L/R thru L, R thru R-channel. 

(xv) PLAY-MODE = 1110B: Play L/R thru L-channel, L thru R-channel. 
(xvi) PLAY-MODE = 1111B: Play L/R thru L-channel, L/R thru R-channel. 


The mnemonic for understanding the PLAY-MODE bits is: the right two bits (bits 1 and 0) stand 
for the speaker right channel output from left and right channels input; the left two bit (bits 3 and 2) 
stand for the speaker left channel output from left and right channels input. 


The TYPE field specifies the format of the Search Address used in the command. The TYPE field 
is defined below. 


IYPERELD = Description 


00 B Specifies SEARCH address in logical block address format. 

01B Specifies SEARCH address in AMIN, ASEC and AFRAME format. 
10B Specifies SEARCH address in track number (TNO) format. 

11B Reserved. 


Table 2.5.3.5-2 Search Address in Logical Block Address format 


ai TT 6. SOE ei 3 ae oe UP 
Bye | | | | | | | | 
ES SENN TEES II RE ENE TOS ERIN SEO ASUTE 
2 | Logical Block Address (MSB) | 
agp on ee 
a ees Ce eres ete 
ee Logical Block Adiess GSE) =~*~*C*C~C*C“—~—“<CSCSCSCS 


Pear (Ree ean en ete ee DRT a SS ERO tee NERD ERR ea aL Sa, 
ed 


The logical block address specifies the logical block address at which the play or pause operation 
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Table 2.5.3.5-3 Search Address in AMIN, ASEC and AFRAME format 


“he Ft eo SON a. Ge oe a eG 

Bye | | | | | | | | 

pene, PaO CR oR NE Ce OT MERE EVAT Aer, 
2 Reserved | 

eee ene ore CDebwictm @MN) ~~ SCOC~CS<SRS 

aL eee eG, 

a D aisatieie FRAME) 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 


Table 2.5.3.5-4 Search Address in Track Number (TNO) format 


2 } Reserved | 
fe eee eg a eer ea 
"the pe eg eee ie a 
5 Dakar NSS 


a a a ald a aa a al ee 


The Track Number field specifies the track in BCD notation at which the play or pause operation 
will begin. This field has a range of 01 to 99 in BCD. 
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2.5.3.6 AUDIO PLAY Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 


Operation Code: Cy 
AUDIO PLAY Command 

; Bitl 7 | 6 | 5 1 4 | 3 1° 2 1 1 1 0 
By | | | | | | | | 

0 Operation Code cara 
Toga UatNumber Spada’ S”*~*éRLAYMODE 
a aa ats 688) 
6 ee a eNO ai win: 

4 | Playback address | 
i: eae Puyback adinss USB) SSCS 


| 
8. 


: 
| 
| 
: 
| 
| 


3 
a 
: 
2 
: 
E 


The AUDIO PLAY command (Table 2.5.3.6-1) request that the target position the optical pickup at 
the Playback address specified and output the audio channels in the specified Play Mode when the 
Playback Address is found. This command returns the status byte when the Playback Address is 
found. If the Playback Address is not found, or if the drive is not ready, or if the address is not 
within an audio track, a CHECK CONDITION status will be returned . 


The AUDIO PLAY command is used to release a PAUSE(hold track) state after the execution of 
AUDIO TRACK SEARCH command or a PAUSE state after the execution of an AUDIO PAUSE 
command. The AUDIO PLAY command can also be used to set a particular completion address or 
PLAY MODE. 


A Stop Address (StopAddr) bit of zero indicates that the playback address is the starting address for 
the audio play operation. In this case, the stop address should be set by a prior AUDIO STOP 
command. A Stopaddr bit of one indicates that the playback address is the stopping address of the 
audio play operation. In this case, the starting address is set by a prior AUDIO TRACK SEARCH 
command. In both cases, if the stopping address is larger than the end of the current audio track, 
the drive should play up to the stop address or until it encounters a data track. The stop address is 


_ default to be the last audio track after power up or media change. If the stop address is smaller than 
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the starting address, the drive will return a CHECK CONDITION with Ilegal Request sense key 
and should not play any audio. The minimum difference between the audio start address and the 
The drive can accept and perform another command which will or will not terminate the current 
audio play operation as described in the underlined section under the AUDIO PAUSE command 
description. 


PLAY-MODE (Byte 01, bits 3 to 0) specifies the play mode as follows: 


(i) | PLAY-MODE = OOOOB: Play with MUTING on. 

(ii) PLAY-MODE =0001B: Play R-channel only thru R-channel only. 
(iii) PLAY-MODE =0010B: Play L-channel thru R-channel only. 

(iv) PLAY-MODE =0011B: Play L/R channels thru R-channel only. 

(v) _PLAY-MODE =0100B: Play R-Channel thru L-channel only. 
(vi)PLAY-MODE = 0101B: Play R-chan thru L, R-chan to R-chan. 

(vii) PLAY-MODE =0110B: Play R thru L, L thm R. 

(viii) PLAY-MODE = 0111B: Play R thru L, L/R thru R. 

(ix) PLAY-MODE = 1000B: Play L channel thru L-channel only. 

(x) PLAY-MODE = 1001B: Play L-channel thru L, R thru R, STEREO. 
(xi) PLAY-MODE = 1010B: Play L-chan thru L, L-chan to R-chan. 

(xii) PLAY-MODE = 1011B: Play L thru L, L/R thru R-channel. 

(xiii) PLAY-MODE = 1100B: Play L/R thru L-channel. 

(xiv) PLAY-MODE = 1101B: Play L/R thru L, R thru R-channel. 

(xv) PLAY-MODE = 1110B: Piay L/R thru L-channei, L thru R-channel. 
(xvi) PLAY-MODE = 1111B: Play L/R thru L-channel, L/R thru R-channel. 


The mnemonic for understanding the PLAY-MODE bits is: the right two bits (bits 1 and 0) stand 
for the speaker right channel output from left and right channels input, the left two bit (bits 3 and 2) 
stand for the speaker left channel output from left and right channels input. 


The TYPE field specifies the format of the Playback Address used in the command. The TYPE 
field is defined below. 


TYPE FIELD Description 
00 B Specifies Playback address in logical block address format. 
01B Specifies Playback address in AMIN, ASEC and AFRAME format. 
10B Specifies Playback address in track number (TNO) format. 
11B Reserved. ‘ 


Table 2.5.3.6-2 Playback Address in Logical Block Address format 


Bit! 7 | 6 | 5 i Ware ee ee ae ee 
Bye | | | | l l | 
ease See ete eta en ne Nee EV RED aCe REPRE 
eet Pe is coke cared case hoi 
a Nias ed 
FS aN eR aan RO 

5 | Logical Block Address (LSB) | 
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eS er rr rrr cr ree cee rere cece eminem arenes cece ani CD anomie the 
SSS re SS a A esa Seas Sa eee See See 


The logical block address specifies the logical block address at which the play operation will begin 
or end depending on the setting of the StopAddr bit. 


Table 2.5.3.6-3 Playback Address in AMIN, ASEC and AFRAME format 


Bit | z | 6 | 5 1 4 | 3 lv 2 | 1 | 0 
| 
Byte | | | | | { | | 
| 
a Ne tree ns Ba rg alee ee ee ye pee 
2 | Reserved | 
---o = |------------- + = nnn nnn nn nnn nnn nnn nn ene nen en enn nnn nnn nn nnn nn nn nnn nnn nnn nee ene e| 
3 | CD-absolute time (AMIN) | 
on [en ann ne ne nnn nnn nnn nner mn nwa nme nen n nnn mn nme enema enn nnn wnn newer enna meee n enn mene enewnn nnn nnnnnee| 
4 | CD-absolute time (ASEC) | 
see [a a al 
5 | CD-absolute time (AFRAME) | 
seas: [ec a s 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 


Table 2.5.3.6 Playback Address in Track Number(TNO) format 


ue eae nee near eR Eee DN eC CT aE CaO ee ECO EPR NT NE oe | 

3 | Reserved | 
is 
dh Ree eae es Lo 


AE AA EET ST ERE St ATS SEAS SO-TSS-SIERD SELANGOR ashranenaverenear=nerant tees ees aah es Sere 
eae Sacre Sa eee SO ES LS SS TL ST 
SY SS SL 
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The Track Number field specifies the track in BCD notation at which the play operation will begin at 


the beginning of the specified track or end at the end of the specified track. This field has a range of 
01to99in BCD. — ( 
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2.5.3.7 AUDIO PAUSE Command 


Peripheral Device Type: CD-Rom 
ion Code Type: Mandatory 
Operation Code: CAY 


Table 2.5.3.7-1 
AUDIO PAUSE Command 

i SF he oS mE ee ko oe a oe 
Byte | | | | | | 

0 Operation Code PPA mete ware 
i Gee ee ee 
eg aa 
yee eer an 
an ear a 
eee ne ena = a aa 
egy aE ee er 
a a ca aa 
sar cca aa ae 
a 9 po Reed | Reed fae te 


The AUDIO PAUSE command (Table 2.5.3.7-1) temporarily stops audio play operation and enter 
the hold track state(i.e. keeps the disc at the same Q SUBCODE address). 


A Pause bit of one has the effect of temporarily stops audio play operation with MUTING ON and 
continuing a search of the same SUBCODE Q ADDRESS. The command is valid for use only 
when the audio play is in progress after the AUDIO TRACK SEARCH or AUDIO PLAY 
commands. A Pause bit of zero release the audio pause operation and resume the audio play 
operation at the same Q subcode address just before the start of the audio pause operation. 


February 15, 1988. 
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2.5.3.8 AUDIO STOP Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 


Operation Code: CBY 


Table 2.5.3.8-1 
AUDIO STOP Command 

7 Bitl 7 | 6 | § 1 4 ar) be 2 | fo ae ia 
Bye | | ‘| | | | 

0 Operation Code eae 
ol eau Need eee, 
se es 088 

3 | Stop address | 
2 

5 | Stop address (LSB) | 
~~ = a al aE | 
a so ane egg ee remeee os 
i acca ema 
9 1 a. TYE | | Reserved tis | Flag | Link a 


The AUDIO STOP command (Table 2.5.3.8-1) specifies the stop address at which the audio play 
operation will stop. The drive will spin down and the optical pickup is held around the area of the 
stop address. 


If the stop address is zero and the TYPE field is O0B, the AUDIO STOP command will perform the 
same function as the REZERO UNIT command. 


The TYPE field specifies the format of the Stop Address used in the command. The TYPE field is 
defined below. 


TYPEFIELD  =—S_—s Description 


00 B Specifies Stop address in logical block address format. 

01B Specifies Stop address in AMIN, ASEC and AFRAME format. 
10B Specifies Stop address in track number (TNO) format. 

11B Reserved. 
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Table 2.5.3.8-2 Stop Address in Logical Block Address format 


, Sie ok eo 2 sl a eh et OR ae a coe 
Bye | | | | | | | 
Ea aed ee ye 
2 | Logical Block Address (MSB) | 
a ee eee [= | 
a 4 Cee ae i 
5 gia Block Address (SB) “| 


The logical block address specifies the logical block address at which the play operation will stop. 


Table 2.5.3.8-3 Stop Address in AMIN, ASEC and AFRAME format 


OB hb 6 Se a oe ee ae a 

Bye | | | | | | | | 

GS | RTE ASN EENT EEE ELIA 
2:1 Reserved | 

i oe oor aaa 

Tg epabedneine (GEG 

5 P_ Debealne ne (FRAME) ee 


Satire a ll as cae a a rac call al le al IGS SI tig ee as | 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 
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Table 2.5.3.8-4 Stop Address in Track Number(TNO) format 


“Si @ ot 6 a So ae OS 

Byte | | | | | | | | 

ame Ge ee wee ee ee eee 
21 Reserved | 

gg ee ee ee eg 

ae ae a: Gee hn re ea etay 

~s. | ee ee re ee mindeGN, ee 


i ae re ais Se es ce i aes | 


The Track Number field specifies the track in BCD notation at which the play operation will stop. 
This field has a range of 01 to 99 in BCD. 
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2.52369 AUDIO STATUS Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: CCy 


Table 2.5.3.9-1 
AUDIO STATUS Command 

a oe SO LS Se ae oe ae eee 
Bye | J | | | | | | 
0 | Operation Code ie 
oT Tae Ree 
Sc aaa Oa ear 
ae Sa aa 
Pee ee eaters 
Bg ge Rin ee ggg ge tee en ee 
So aR ag (IT I rea ala | 
~~? yRewened TSC ea [Fag | Link | 


This command (Table 2.5.3.9-1) transfers the current audio play status and the starting Q 
SUBCODE address of next track. 


The allocation length specifies the number of bytes that the initiator has allocated for returned data. 
An allocation length of zero indicates that no data will be transferred. Any other value indicates the 
maximum number of bytes that will be transferred. The target terminates the DATA IN phase when 
allocation length bytes have been transferred or when all available data has been transferred to the 
initiator, whichever is less. 


When the CD-Rom is not in READY state, a check condition is returned. 
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Table 2.5.3.9-2 Audio Status Data ft 
“ore 6. Se a a ee oe. Cp Cee 
| 
Byte | | | | | | | | 
| 
0 | Status Field car 
Sepecee | eannnnnnnnannnnnnnnnnnnnnnnnnnnnnmnennnnnnne nnn ene nnenen anna nnn nec ennnnnnnneerenmewcceenneennennnneee| 
1 | Reserved | Play Mode | 
siete [nanan ea mew ne mane nnnannnnn anne nen nnn nc wae nnn nnn mene n enna n nen neenennnnnnenenneenonse| 
2 | Reserved | Control Field of current track | 
eed [aeonnennnnnnnnnnnnnnnnnannnennnnnannnnemneneneneneeennnnnmnnenennnnn nnn ennennnnnacenaennnnnenmencnemumnneeene| 
2-1] Current Q-Subcode (AMIN) | 
be | panne nner ener ennnnnatanennsstsnnnnmacwscncesetennnnnnanaaneerunnaone| 
4 | Current Q-Subcode (ASEC) | 
eaters |an-nnnnnnnnnnnnnnnnnnnn nance mreenn renee nn nnn nnn nnn nnn ner eremnn nnn ennenen nee ennenccennnnnenennenne| 
aa Current Q-Subcode (AFRAME) | 


The Status field is defined as follows: 


S Field Deeessa 

00H Audio play operation in progress following execution of AUDIO 
TRACK SEARCH command (Play bit = 1) or AUDIO PLAY ( 
command. 

01H PAUSE (i.e. hold track state) operation in progress. 

02H MUTING-ON operation in progress after execution of AUDO 
TRACK SEARCH command or AUDIO PLAY command. 

03H Audio play completion status. 

04H Exror occurred during audio play. operation. 

05H Audio play operation not requested. 


The Control Field of the next track is defined as follows. 


| BIT I Content | 
| 3 a 0 | | 
i 0 f oO | xX | 0 | 2 Audio Channels WITHOUT Pre-Emphasis 

| 0 1 oOo | xX J 1 | 2 Audio Channels WITH Pre-Emphasis 

! 1 oOo | xX | 0 | 4 Audio Channels WITHOUT Pre-Emphasis 

1 1 1 oO | xX | 1 | 4 Audio Channels WITH Pre-Emphasis 

| O E-d ot- aXe 0 | Data Track 

| 0 re  , e 1 | Reserved 

| 1 fb. | XX xX | Reserved 

| X | X | O f X | Digital Copy Prohibited 

[UR od oe bs SS dic CX 

| | 


| Digital Copy Permitted 
I 
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PLAY-MODE (Byte 01, bits 3 to 0) specifies the play mode status as follows: 


PLA Y-MODE = 0000B: 
PLAY-MODE = 0001B: 
PLAY-MODE = 0010B: 
PLAY-MODE = 0011B: 
PLAY-MODE = 0100B: 
PLAY-MODE = 0101B: 
PLAY-MODE = 0110B: 
PLAY-MODE = 0111B: 
PLAY-MODE = 1000B: 
PLAY-MODE = 1001B: 
PLAY-MODE = 1010B: 
PLAY-MODE = 1011B: 
PLAY-MODE = 1100B: 
PLA Y-MODE = 1101B: 
PLAY-MODE = 1110B: 
PLAY-MODE = 1111B: 


Play with MUTING on. 

Play R-channel only thru R-channel only. 
Play L-channel thru R-channel only. 

Play L/R channels thru R-channel only. 
Play R-Channel thru L-channel only. 

Play R-chan thru L, R-chan to R-chan. 
Play R thru L, L thru R. 

Play R thru L, L/R thru R. 

Play L channel thru L-channel only. 

Play L-channel thru L, R thru R, STEREO. 
Play L-chan thru L, L-chan to R-chan. 
Play L thru L, L/R thru R-channel. 

Play L/R thru L-channel. 

Play L/R thru L, R thru R-channel. 

Play L/R thru L-channel, L thru R-channel. 
Play L/R thru L-channel, L/R thru R-channel. 


The mnemonic for understanding the PLAY-MODE bits is: the right two bits (bits 1 and 0) stand 
for the speaker right channel output from left and right channels input, the left two bit (bits 3 and 2) 
stand for the speaker left channel output from left and right channels input. 
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2.5.3.10 AUDIO SCAN Command 


Peripheral Device Type: CD-Rom 
Operation Code Type: Mandatory 
Operation Code: CoH 


Table 2.5.3.10-1 
AUDIO SCAN Command 


| 
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! 
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! 
! 
i 
t 
i 
‘ 
! 
‘ 
H 
‘ 
{ 
t 
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} 
t 
t 
' 
' 
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1 | Logical Unit Number | Direct | Reserved | 
2 Sea aig ats 88) 
| SCAN Starting Address | 
a ee : 
5 SAN Sing Aas 38) 
6 | Reserved | 
Sages nee eo gap ne | 
apie es eg ! 
9 i Se a ne | 


The AUDIO SCAN command requests a fast-forward or fast-reverse scan operation starting from 
the Scan Starting Address. 


The drive can accept and perform another command which will or will not terminate the current 


audio scan operation as described in the underlined section under the AUDIO PAUSE command 
description. 


A direction (DIRECT) bit of zero indicates a fast-forward operation. A DIRECT bit of one indicates 
a fast-reversed operation. 


SCAN Starting Address - Specifies the address to begin the Audio Fast scan at. The manner of 
address definition varies with the TYPE field. 


The TYPE field specifies the format of the Scan Starting Address used in the command. The TYPE 
field is defined below. 
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TYPEFIELD- —_ Description 


00 B Specifies Scan Starting address in logical block address format. 

01B Specifies Scan Starting address in AMIN, ASEC and AFRAME 
format. 

10B Specifies Scan Starting address in track number (TNO) format. 

11B Reserved. 


Table 2.5.3.10-2 Scan Starting Address in Logical Block Address format 


Bit). Fo de eg a Oa Be ee > 0 
Bye | | | | | l | 
Se eee we ee ene 

20 Logical Block Address (MSB) | 
ay ee ene a rg a 
ge og gag 
i Regia Blk Aas (ape ee ! 


The logical block address specifies the logical block address at which the Scan operation will begin. 


Table 2.3.5.10-3 Scan Starting Address in AMIN, ASEC and AFRAME format 


Bit] 7 | 6 r | 4 i 3 lL 2 oe | | 0 
Bye | | | l l | | | 

2 | Reserved | 
a 
7 ai er CD-absolute time (ASEC) ee ee 

5 | CD-absolute time (AFRAME) | 


ssa | cer na aS Ne a es Bl 


The AMIN, ASEC and AFRAME fields specifies the relative running time from the beginning of 
the disc. The AMIN field has a range of 00 to 99 in BCD. The ASEC ranges from 00 to 59 in 
BCD. The AFRAME field has a range of 00 to 74 in BCD. 


Apple Computer Inc. Confidential Page 74 


February 15, 1988. Apple CD ROM SCSI Command Set 062-2097 Revision 1.4 


Table 2.5.3.10-4 Scan Starting Address in Track Number(TNO) format 


Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 
| 
Byte | | | | | | | | 
Gales iors ten aa a ee ea ee gh a eee nae kee a ihe had 
2 | Reserved | 
sess [eee een acme deci cemecanenmesnetastaal 
3 | Reserved | 
en [enna nnanwennnwcn enn ann wnnnn enn wnn nnn nnewen owen wenn enn ween ern mnnnn een e meee nnn n nn nn nnn nnn nnnnnn nen wenn nnn =e] 
4 | Reserved | 
------- [enna aa nnn nn nnn nn enn nnn nen nnn nn wenn nee mene nen nnn een e neem en nen enn nnn ence men enennnenn==-| 
5 Track Number (TNO) | 
cemeeee [nae nn n-ne nn nnn nnn nnn nn nnn nnn enw cm ene cn cone enn ne een en en ceeen ee | 


The Track Number field specifies the track in BCD notation at which the scan operation will begin. 
This field has a range of 01 to 99 in BCD. 
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Physical 
Depth 
Width 
Height 
Weight 


General 

Disc 
Recording surfaces 
Disc diameter 
Disc center hole 
Thickness 
Track pitch 
Scanning velocity 
Rotation speed 


Latency (average) 

Blocks per rotation 
Data 

Data capacity 


Number of blocks/disc 
Data per block 


Address description 
Audio capacity 
Playing time 
Data streaming rate 
Blocks per second 
User bytes per second 


SCSI bus transfer rate 

Modes supported 
CD-ROM 
CD-Audio 
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Specifications 


266mm _ (10.47 inches) 
246 mm _ (9.69 inches) 
8 mm (3.31 inches) 
40 kg (8.8 lbs.) 


12cm 

15mm 

1.2 mm 

1.6 microns (15,875 tracks per inch) 
1.2~1.4 meters per second 

Varies over radius 

~530 to 230 rpm 

~§5 to 130 milliseconds 

~8.4 to 19.5 variable 


656 MB, Mode 1 

748 MB, Mode 2 

270,000 

2048 bytes, Mode 1 

2336 bytes, Mode 2 
Minutes, seconds, frames 


1 hour 


75 blocks per second 
153.6K, Mode 1 
175.2K, Mode 2 

800 K per second 


Modes C1 and C2 (Phillips/Sony Yellow book) 
(hillips/Sony Red book) 
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Environmental — 


Noise (maximum) 
Drive on (seek or non-seek) <46 dB(A) 


Temperature 
Operating Temperature +10°C (+507°F) to +40°C (+104°F) 
Storage (6 months) -30°C (-22°F) to +50°C (122°F) 
Transit (72 hours) -30°C (-22°F) to +§5°C (+131°F) 
Humidity 


Classified as Class 1 equipment 


Power requirements 


AC Input CUS and Canada) 120V AC £10%, 58 to 62 Hz 
AC Input (Universal) 100/120/200/220/240V AC £10%, 
48 to 62 Hz 
Power Consumption 
Drive on 40 watts 
Interface 
SCSI expansion ports 50-pin connector 
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